Resolve402 / services

Decision makers

GET /api/decision-makers · $0.02 per call (USDC on Base or Solana, x402)

Company directors in France and the United Kingdom (CEO, président, gérant, managing director) with their probable business email, in one call. From a SIREN, a UK company number, a company name or a web domain: legal officers (official registries: RNE in France, Companies House in the UK), web domain, mail provider, latest revenue and net income (France), and a probable work email per officer from the pattern seen on the company's own pages (observed_on_site) or the common one (default_fr, default). Not SMTP-verified (verified:false). Charged only if officers are found. Nothing stored (GDPR). 20 free calls/day per IP with header X-Free-Trial: 1.

Problem solved

You have a French or British company (name, SIREN, UK company number or web domain) and need who runs it (CEO, président, gérant, DG, managing director) plus a business email to reach them.

Use cases

• Enrich a lead list of French or UK companies with the people who decide and a probable work email.
• Chain after people search or hiring signals: once you know which company to contact, get who to write to.

Input

GET /api/decision-makers?siren=<9 digits> | ?company_number=<UK Companies House number> | ?company=<name>[&country=gb] | ?domain=<domain> (domain alone: the SIREN or UK company number is read from the site's legal pages)

Output

Returns company (France: siren, NAF, financials; UK: country GB, company_number, sic_codes), web domain (with confidence and evidence), mail provider (Google, Microsoft 365, Proofpoint, Mimecast...), and per officer (executives first: PDG, président, gérant, DG, directoire, chief executive, managing director, then board-only members, non-executive directors and company secretaries; role_rank 1-8 and is_executive say why): name, role, probable email {address, pattern, pattern_source, confidence, evidence?, verified:false} and email_alternatives. pattern_source "observed_on_site" = the pattern was read from named addresses published on the company's own public pages (contact, legal notice, press, team; robots.txt honoured; addresses counted, never returned), confidence medium (1 address) or high (2+ concordant); "default_fr" (France) or "default" (UK) = common pattern, confidence low. Never SMTP-verified. 404 = not found, not charged.

Price

$0.02 per call. Charged only if officers are found: 404 company_not_found, no_named_officer or no_registry_id_on_site (and 503 uk_registry_unavailable) is not charged.

Free tier: 20 free calls per day per client IP (UTC day, shared with the other free-tier services), no wallet needed. Opt in with the header X-Free-Trial: 1 (or free_trial=1 in the query) and no payment header: the answer carries X-Free-Quota-Remaining, X-Free-Quota-Limit and "billing": {"free_tier": true, "remaining": N}. Without the opt-in, or past the quota, the usual 402. Paid calls never use the free quota.

Example

GET https://resolve402.dev/api/decision-makers?siren=552032534

{
  "company": {
    "siren": "552032534",
    "name": "DANONE",
    "city": "PARIS"
  },
  "domain": {
    "domain": "acme.fr",
    "confidence": "high",
    "evidence": "siren_on_homepage"
  },
  "mail_provider": "google_workspace",
  "officers": [
    {
      "first_name": "Claire",
      "last_name": "Martin",
      "role": "Président de SAS",
      "email": {
        "address": "claire.martin@acme.fr",
        "pattern": "prenom.nom",
        "pattern_source": "observed_on_site",
        "confidence": "high",
        "verified": false
      }
    }
  ]
}

Bazaar discovery example served in the production 402 (abridged; the officer and domain are illustrative placeholders).

Sources

• Registre national des entreprises (INSEE Sirene / INPI RNE) via recherche-entreprises.api.gouv.fr
• Companies House (UK company profile and officers, public data API or public register pages)
• The company's own public pages (contact, legal notice, press, team) for the email pattern, robots.txt honoured
• DNS MX records for the mail provider

Limits

• France and the United Kingdom only. UK: no financials (null); active natural-person officers only (corporate and nominee officers excluded).
• Emails are probable, not SMTP-verified (verified:false): use email_alternatives and confidence, and say so to the user.
• At most 5 officers per company, ranked by executive relevance (role_rank): operational executives before supervisory or board-only members. Statutory auditors get no email.
• Nothing stored. GDPR opt-out: POST /api/opt-out.

Use it

• HTTP + x402: call the URL, pay the 402 with any x402 v2 client, retry with the PAYMENT-SIGNATURE header.
• OpenAPI: /openapi.json (operation decisionMakers )
• MCP server: coming soon
• Agent guide: /llms.txt · skill: /SKILL.md

All services