Developer centerv1.0.0
Documentation menu
API reference

Search sanctions with JSON

Contract for POST /public/search.

POST/public/search

Recommended for multiple identifiers, multiple source filters or a structured JSON request.

Authentication

Use the x-api-key header when possible; Authorization: ApiKey is also supported.

Parameters

No path or query parameters.

Request body

SearchQuery

{
  "name": "Example Person",
  "type": "person",
  "birthDate": "1980-05-12",
  "country": "TR",
  "identifiers": [
    {
      "type": "passport",
      "value": "AA123456"
    }
  ],
  "pageSize": 10
}

Responses

HTTPDescriptionSchema
200Successful responseSearchResponse
400Invalid or missing request dataErrorResponse
401Authentication is missing or invalidErrorResponse
403Account, permission, source scope, domain or IP restriction failedErrorResponse
429Usage, rate or page size limit exceededErrorResponse
500Server errorErrorResponse
503Temporary service dependency failureErrorResponse

Code examples

curl -X POST "https://api.sanctions.tr/public/search" \
  -H "content-type: application/json" \
  -H "x-api-key: $SANCTIONS_API_KEY" \
  -d '{"name":"AEROCARIBBEAN AIRLINES","sources":["OFAC"],"pageSize":5}'

Decision boundary

An API result is a candidate match. A final sanctions or compliance decision requires official-source verification and human review.