The API is plain REST with JSON responses. Everything below runs against the live index — 25 searches are free, no card required.
Book a call or email hr@satyapan.xyz and we issue a sandbox key the same day. Send it with every request as the X-API-Key header.
One GET request. name is the only required parameter.
curl "https://praman-labs.xyz/api/v1/entities?name=Vladimir%20Putin&limit=5" \
-H "X-API-Key: YOUR_KEY"Matches come ranked, with structured evidence on every record — sanctions listings with issuing authority and active status, PEP positions with class, and source attributions traceable to the issuing feed.
{
"total": 6290,
"results": [{
"name": "Vladimir Vladimirovich Putin",
"entity_type": "person",
"match_score": 0.99,
"risk": ["sanction", "pep"],
"countries": ["RU"],
"links": { "details_url": "/api/v1/entities?id=..." }
}]
}All filters are optional and combinable. DOB and country act as discriminators — a record missing those fields is never silently excluded.
| parameter | values | notes |
|---|---|---|
name | free text | Required. Names, aliases, transliterations |
entity_type | person · organization · vessel · aircraft | Exact filter |
countries | ISO codes, repeatable | Boosts and filters by country |
dob | 1952 · 10-1952 · 1952-10-07 | Any precision; discriminator, not a gate |
fuzziness | 0 · 1 · 2 · AUTO | Edit distance; AUTO adapts to name length |
limit / offset | 1–100 / 0+ | Pagination |
Every result links to its full profile — aliases, identifiers, listings, positions, relationships and addresses.
curl "https://praman-labs.xyz/api/v1/entities?id=ENTITY_ID&include=summary" \
-H "X-API-Key: YOUR_KEY"Batch screening accepts up to 500 queries per request on Scale plans, and full database snapshots ship as JSON or CSV flat files for on-premise matching. See pricing and the full schema reference.