Search sanctions with GET

Contract for GET /public/search.

GET/public/search

Search the normalized sanctions dataset with an API key. Domain and IP restrictions, source scope, page size and usage limits are enforced by policy. Explainability fields show why each candidate matched.

Authentication

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

Parameters

Field	In	Type	Description
`name` *	query	`string`	Required legal name, display name or known alias to search.
`type`	query	`EntityType`	Optional entity type filter.
`gender`	query	`string`	Optional gender filter for person records.
`birthDate`	query	`string`	Optional birth date filter in YYYY, YYYY-MM or YYYY-MM-DD format.
`nationality`	query	`string`	Optional nationality filter for person records.
`country`	query	`string`	Optional entity or address country filter.
`source`	query	`string`	Filter by requested or matched canonical source.
`sources`	query	`string`	Optional multiple source filter.
`identifier`	query	`string`	Optional single identifier value for GET requests.
`page`	query	`integer`	One-based page number.
`pageSize`	query	`integer`	Results per page, capped by the API key policy.

Responses

HTTP	Description	Schema
`200`	Successful response	SearchResponse
`400`	Invalid or missing request data	ErrorResponse
`401`	Authentication is missing or invalid	ErrorResponse
`403`	Account, permission, source scope, domain or IP restriction failed	ErrorResponse
`429`	Usage, rate or page size limit exceeded	ErrorResponse
`500`	Server error	ErrorResponse
`503`	Temporary service dependency failure	ErrorResponse

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.