Skip to main content
POST
Read a batch of saved source observations
Send one to 25 unique resources as operation/id pairs, using the returned IDs from your own account. Allowed operations are getListing, getAuction, getStay, getDevelopment, getAgent, getAgency, getProperty and getMarket. Each result is the same public data returned by that operation. This request makes no source calls and does not renew retention. Missing, expired or inaccessible resources have per-item failure outcomes. Reserve one credit per requested resource; successful reads cost one credit each and failures cost zero. Existing idempotent replays are free. Field projection and CSV/NDJSON exports apply to the batch outcomes. Scoped keys require batchReadObservations plus each selected read operation (or wildcard access). A disallowed read produces an INSUFFICIENT_SCOPE item and costs zero.

Authorizations

x-api-key
string
header
required

Query Parameters

fields
string

Response-only comma-separated field paths relative to data items; up to 32 paths. Source requests and billing are unchanged.

Maximum string length: 4127
format
enum<string>
default:json

Response-only export format. JSON retains the envelope; CSV/NDJSON contain data records, with request/credit metadata in headers. Errors stay JSON.

Available options:
json,
csv,
ndjson

Body

application/json
resources
object[]
required
Required array length: 1 - 25 elements

Response

Source observation; inspect meta for evidence and completeness.

data
object[]
required
Required array length: 1 - 25 elements
meta
object
required