Skip to main content
POST /api/v2/buyer/property-lists/check Lints a candidate identifier set against the AAO Community Registry and curation rules without creating anything. Use it before a bulk import to see which entries are clean, which are canonicalized, which should be dropped, and which need manual review.

​
Request

curl -X POST https://api.interchange.io/api/v2/buyer/property-lists/check \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "identifiers": [
      { "type": "domain", "value": "example-times.com" },
      { "type": "domain", "value": "duplicate.com" },
      { "type": "domain", "value": "duplicate.com" },
      { "type": "ios_bundle", "value": "com.facebook.katana" }
    ]
  }'

​
Parameters

FieldTypeRequiredNotes
domainsstring[]NoShorthand for identifiers of type: "domain". Up to 100,000
identifiersobject[]NoTyped { type, value }. Up to 100,000
Provide domains, identifiers, or both; the combined total must be 1–100,000. Non-domain identifiers (mobile/CTV) are not yet checked against AAO and always land in the assess bucket.

​
Response

{
  "summary": { "total": 4, "remove": 1, "modify": 0, "assess": 1, "ok": 2 },
  "ok": [
    { "domain": "example-times.com", "source": "aao", "identifier": { "type": "domain", "value": "example-times.com" } }
  ],
  "modify": [],
  "remove": [
    { "input": "duplicate.com", "canonical": "duplicate.com", "reason": "duplicate", "identifier": { "type": "domain", "value": "duplicate.com" } }
  ],
  "assess": [
    { "domain": "com.facebook.katana", "identifier": { "type": "ios_bundle", "value": "com.facebook.katana" } }
  ],
  "reportId": "rpt_abc123",
  "reportIds": ["rpt_abc123"]
}
Entries are grouped into buckets — ok (safe to include), modify (canonicalized), remove (duplicate or blocked), and assess (manual review). Each entry carries an identifier: { type, value } mirroring the input. reportId (and reportIds[] when domain input is chunked) is returned only when at least one domain was submitted; bundle-only requests return no report IDs.

​
Errors

  • 400 VALIDATION_ERROR — empty identifier set or combined total above 100,000.
See Errors for the full error contract.

Property list tasks

All property list operations

Property Lists guide

Check buckets and identifier types

Get check report

Retrieve a stored check report by ID

Create property list

Commit a validated set to a list