API documentation

Introduction to the sanctions.tr API contract, data models and secure integration guides.

The sanctions.tr API normalizes Turkish and global official sanctions lists behind one search contract. This center documents only the approved customer integration surface.

What is documented?

Server-to-server sanctions search with API keys
Explainable scores, match quality and official-source references
Tenant admin search and API key access reports
Typed request, response, error and pagination models
Safe tool-design guidance for AI agents

Scope boundary

Internal administration, import operations and the first-party anonymous site search are excluded. /public/site-search is a limited website-only contract, not a customer integration API.

Base URL

https://api.sanctions.tr

Public search uses API keys; tenant reports use tenant admin JWT authentication. Never embed an API key in browser JavaScript or a mobile application.

Version and source

These pages are statically generated from OpenAPI 1.0.0. The machine-readable English contract is available at /openapi.json; the Turkish contract is available at /openapi.tr.json.

Decision boundary

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