NameCheck360 API
Search people and companies, profiles, sanctions and sections as JSON, with the same rules as the website.
Authentication
Create a key in Account > API keys (Business and Enterprise plans), then send it in the Authorization header (or X-Api-Key).
curl -H "Authorization: Bearer nc360_xxxxxxxx_…" https://namecheck360.com/api/v1/usage
- Opening a new profile counts one consultation of the month, as on the website; reading it again the same month is free.
- AI research is deducted from the organisation’s monthly AI credits.
- Limit: 120 requests per minute and per key.
- Every call is written to the organisation’s activity log.
- Confidential mode is not available through the API.
Typical flow
- GET /search: find the right person or company among the candidates (free).
- POST /profiles with the candidate’s “token”: the profile is opened and its research queued.
- POST /profiles/{profile}/work, repeated until “pending”: 0 (each call runs one step, 10 to 60 s).
- GET /profiles/{profile}/sections/{section} to read each section (sanctions, pep, adverse, wealth…).
GET /api/v1/usage
Consultations, re-openings and AI credits of the month.
Response
{"plan":"business","period":"2026-10","profiles":{"used":12,"limit":400},"watched_reopenings":{"used":3,"limit":500},"ai_credits":{"used":240,"limit":10000,"left":9760},"max_power":"deep"} GET /api/v1/search?q=Bernard%20Arnault&type=person
Candidates from the free sources (Wikidata, registers, GLEIF, sanctions lists). Optional filters: country, year, city, company. No consultation counted.
Response
{"query":"Bernard Arnault","type":"person","candidates":[{"name":"Bernard Arnault","birth_date":"1949-03-05","country":"France","source":"wikidata","wikidata_id":"Q32055","profile":"bernard-arnault-1949","token":"eyJ…"}]} POST /api/v1/profiles
Opens a candidate’s profile (“token”) or, without a candidate, creates it from criteria: name + at least two of year, country, role, context.
Body (JSON)
{"token":"eyJ…","type":"person"} Response
{"profile":"bernard-arnault-1949","name":"Bernard Arnault","risk":{"score":36,"level":"medium"},"pending":12,"sections":{"identity":{"status":"queued"}}} GET /api/v1/profiles/{profile}
Profile summary and state of every section. Counts one consultation the first time in the month.
POST /api/v1/profiles/{profile}/work
Runs the next research step and returns the profile state. Call until “pending” is 0.
GET /api/v1/profiles/{profile}/sections/{section}
Data of one section, with its sources, date and AI level.
Response
{"profile":"bernard-arnault-1949","section":"sanctions","status":"ready","data":{…},"sources":[…]} POST /api/v1/profiles/{profile}/refresh
Researches sections again at the chosen AI level, within the plan. Estimated cost in credits in the answer.
Body (JSON)
{"sections":["wealth","adverse"],"power":"standard"} Response
{"profile":"bernard-arnault-1949","queued":2,"power":"standard","estimated_credits":12} Errors
{"error": {"code": "credits_exhausted", "message": "Not enough AI credits left this month."}}
401 unauthorized · 402 quota_exhausted / credits_exhausted · 403 section_not_in_plan · 404 not_found · 409 not_opened · 422 invalid_query / invalid_token / criteria_needed · 429 rate_limited · 502 source_error