API v1

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

  1. GET /search: find the right person or company among the candidates (free).
  2. POST /profiles with the candidate’s “token”: the profile is opened and its research queued.
  3. POST /profiles/{profile}/work, repeated until “pending”: 0 (each call runs one step, 10 to 60 s).
  4. 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