GET ile yaptırım araması

GET /public/search endpoint sözleşmesi.

GET/public/search

API hesabı kullanımına açıktır. `x-api-key` önerilir; `Authorization: ApiKey <key>` alternatifi de desteklenir. Domain/IP kısıtları, allowed source scope ve limit policy API key üzerinde uygulanır. `score`, `matchQuality`, `scoreDetails` ve `matchedFields` alanları match kararını şeffaf biçimde açıklar.

Kimlik doğrulama

Önerilen kullanım x-api-key header’ıdır; Authorization: ApiKey alternatifi desteklenir.

Parametreler

Alan	Konum	Tip	Açıklama
`name` *	query	`string`	Aranacak kişi/kurum/liste adı.
`type`	query	`EntityType`	İsteğe bağlı varlık tipi filtresi.
`gender`	query	`string`	Kişi kayıtları için opsiyonel cinsiyet filtresi.
`birthDate`	query	`string`	YYYY, YYYY-MM veya YYYY-MM-DD.
`nationality`	query	`string`	Kişi kayıtlarında uyruk filtresi.
`country`	query	`string`	Entity country veya address country eşleşmesi.
`source`	query	`string`	Tek kaynak filtresi. Canonical kaynaklar: OFAC, MASAK, EU_RESTRICTED, UK_HMT, UN_CONSOLIDATED. Kabul edilen alias'lar: OFAC_SDN, OFAC_ALT, EU, UK, UN.
`sources`	query	`string`	Virgülle ayrılmış çoklu kaynak filtresi. Örn: `OFAC,EU,UN`.
`identifier`	query	`string`	Tekil identifier değeri. Çoklu arama için POST body `identifiers` kullanın.
`page`	query	`integer`	Sayfa numarası. Varsayılan: 1.
`pageSize`	query	`integer`	Sayfadaki kayıt adedi. Varsayılan: 25, maksimum: 100.

Cevaplar

HTTP	Açıklama	Schema
`200`	Arama sonucu	SearchResponse
`400`	Eksik veya hatalı istek	ErrorResponse
`401`	API anahtarı eksik, geçersiz veya pasif	ErrorResponse
`403`	Hesap pasif, kaynak yetkisi yok veya domain/IP kısıtına takıldı	ErrorResponse
`429`	API limit veya pageSize limiti aşıldı	ErrorResponse
`500`	Sunucu hatası	ErrorResponse
`503`	Geçici servis bağımlılığı hatası	ErrorResponse

Kod örnekleri

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}'

Karar sınırı

API sonucu aday eşleşmedir. Nihai yaptırım veya uygunluk kararı resmî kaynak doğrulaması ve insan incelemesi gerektirir.