Skip to main content
POST
/
property-lists
/
check
Check property list
curl --request POST \
  --url https://api.interchange.io/api/v2/buyer/property-lists/check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "summary": {
    "total": 123,
    "remove": 123,
    "modify": 123,
    "assess": 123,
    "ok": 123
  },
  "remove": [
    {
      "input": "<string>",
      "canonical": "<string>",
      "reason": "duplicate",
      "domain_type": "<string>",
      "blocked_reason": "<string>",
      "identifier": {
        "type": "domain",
        "value": "<string>"
      }
    }
  ],
  "modify": [
    {
      "input": "<string>",
      "canonical": "<string>",
      "reason": "<string>",
      "identifier": {
        "type": "domain",
        "value": "<string>"
      }
    }
  ],
  "assess": [
    {
      "domain": "<string>",
      "identifier": {
        "type": "domain",
        "value": "<string>"
      }
    }
  ],
  "ok": [
    {
      "domain": "<string>",
      "source": "<string>",
      "identifier": {
        "type": "domain",
        "value": "<string>"
      }
    }
  ],
  "reportId": "<string>",
  "reportIds": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.agentic.scope3.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key or access token

Body

application/json

Request body for checking domains and bundles

​
domains
string[]

Domain values to check (convenience shorthand for identifiers with type: "domain").

Maximum array length: 100000
Minimum string length: 1
​
identifiers
object[]

Typed identifiers to check (domains and mobile app bundle IDs). Provide domains, identifiers, or both; combined total must be 1..100000. Bundle identifiers are not currently checked against the AAO registry and are returned in the assess bucket pending upstream support.

Maximum array length: 100000

Response

Check property list

​
summary
object
required
​
remove
object[]
required
​
modify
object[]
required
​
assess
object[]
required
​
ok
object[]
required
​
reportId
string

Primary AAO registry report ID (equals reportIds[0] when domains were checked). Omitted when the request contained only bundle identifiers (AAO does not currently check bundles).

​
reportIds
string[]

All registry report IDs for this check. Contains one ID when the input fits in a single registry call, and multiple IDs when the domain input was chunked. Omitted when the request contained only bundle identifiers.