Agents

Production summary with buyer/seller/dual split + previous period

postapi.modelmatch.com/v1/agents/analytics/summary

Authorization

x-api-keystringrequired

API key or OAuth token. See Authentication.

Body application/json

idstring

idsstring[]

periodenum

Pre-aggregated period block. Rolling windows (last30Days, last60Days, last90Days, previousMonth, currentMonth) are NOT accepted here and return 400; they are supported on the loans, sales and market endpoints (list, count, breakdowns, analytics summary / time-series / chart) (see DatedPeriod).

Options:2017201820192020202120222023202420252026last3Monthslast6Monthslast12Monthslast14Monthslast16Monthslast18Monthslast24MonthsyearToDateallTime

Responses

200objectSided summary with previous-period comparison

Show attributes

currentobjectrequired

Show child attributes

buyerobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

buyerPctnumberrequired

dualobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

dualPctnumberrequired

sellerobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

sellerPctnumberrequired

totalobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

previousobjectrequired

Show child attributes

buyerobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

buyerPctnumberrequired

dualobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

dualPctnumberrequired

sellerobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

sellerPctnumberrequired

totalobjectrequired

Show child attributes

avgListPricenumberrequired

avgSalePricenumberrequired

unitsnumberrequired

volumenumberrequired

400objectValidation error

401objectUnauthorized

403objectForbidden (authenticated, but missing required context — e.g. no active organization)

404objectNot found

413objectResponse payload too large — detail endpoint capped to fit Lambda response limits

503objectSearch timed out or the cluster is overloaded — retry after `Retry-After` seconds.

curl -X POST "https://api.modelmatch.com/v1/agents/analytics/summary" \
  -H "x-api-key: $MODEL_MATCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "period": "2017",
    "id": "<string>"
  }'

import { createClient } from "@model-match/api";

const client = createClient({ apiKey: process.env.MODEL_MATCH_API_KEY });

const { data, error } = await client.agents.analyticsSummary({
  body: {
    period: "2017",
    id: "<string>"
  }
});

import os
import requests

res = requests.post(
    "https://api.modelmatch.com/v1/agents/analytics/summary",
    headers={"x-api-key": os.environ["MODEL_MATCH_API_KEY"]},
    json={
        "period": "2017",
        "id": "<string>"
    },
)
data = res.json()

200 response

{
  "current": {
    "buyer": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    },
    "buyerPct": 123.45,
    "dual": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    },
    "dualPct": 123.45,
    "seller": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    },
    "sellerPct": 123.45,
    "total": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    }
  },
  "previous": {
    "buyer": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    },
    "buyerPct": 123.45,
    "dual": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    },
    "dualPct": 123.45,
    "seller": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    },
    "sellerPct": 123.45,
    "total": {
      "avgListPrice": 123.45,
      "avgSalePrice": 123.45,
      "units": 123.45,
      "volume": 123.45
    }
  }
}