People search

GET /api/people-search · $0.05 per call (USDC on Base or Solana, x402)

Find decision makers of French companies by role (CEO, président, DG, gérant), sector (NAF), place, headcount and revenue or net income range, from the official registry (Sirene + RNE). Up to 25 people per call, one per company, with SIREN, NAF, city, size and latest revenue. Chain with /api/decision-makers for their probable business email. Charged only if someone matches.

Problem solved

You need a list of decision makers (CEO, président, DG, gérant) of French companies in a sector, a place and a size range.

Use cases

Build a prospect list: CEOs of IT companies (NAF J) in the Rhône with 50+ employees and more than 5 M€ revenue.
Then call decision makers on the companies you keep to get their probable business email.

Input

Parameter	Where	Type	Description
`role`	query	string	ceo (default), president, dg, gerant or any_executive
`sector`	query	string	NAF section letter (A-U, e.g. J = information & communication) or NAF code (62.01Z)
`department`	query	string	French department code, e.g. 75, 69, 2A
`region`	query	string	INSEE region code, e.g. 11 (Île-de-France)
`postal_code`	query	string	5-digit postal code
`min_employees`	query	integer	Minimum headcount (Sirene brackets)
`min_revenue`	query	string	Minimum revenue in EUR, latest published accounts (5000000, 5M, 500k)
`max_revenue`	query	string	Maximum revenue in EUR
`min_net_income`	query	string	Minimum net income in EUR (0 = profitable only)
`max_net_income`	query	string	Maximum net income in EUR (-1 = loss-making only)
`keywords`	query	string	Free text on the company name or activity
`limit`	query	integer	1-25, default 10
`page`	query	integer	Page of companies, default 1

Output

Up to 25 people (one per company) from the official registry, with company SIREN, NAF, city, headcount and latest revenue / net income (year given). Each result has "next" = the /api/decision-makers call for emails. 404 = no match, not charged.

Price

$0.05 per call. Charged only if at least one person matches: 404 no_match is not charged.

Example

GET https://resolve402.dev/api/people-search?role=ceo&sector=J&department=69&min_employees=50

{
  "count": 1,
  "total_companies_matching": 378,
  "people": [
    {
      "first_name": "COLMAN",
      "last_name": "DEEGAN",
      "role": "Président du conseil d’administration et directeur général",
      "company": {
        "siren": "413567132",
        "name": "ZAYO INFRASTRUCTURE FRANCE",
        "naf": "61.10Z",
        "city": "LYON",
        "headcount": "50-99",
        "financials": {
          "year": 2024,
          "revenue_eur": 41200000,
          "net_income_eur": 2300000
        }
      },
      "next": "https://resolve402-kinze.vercel.app/api/decision-makers?siren=413567132"
    }
  ]
}

Bazaar discovery example served in the production 402 (abridged to one person).

Sources

Official French registry (Sirene + RNE) via recherche-entreprises.api.gouv.fr, including the latest published annual accounts

Limits

French companies only, active companies, largest first.
Revenue filters exclude companies that file their accounts confidentially (many small companies do).
Place filters match companies with at least one establishment there; the headquarters may be elsewhere.
No email here: call decision makers on the people you keep. Birth dates are never returned.

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 peopleSearch )
MCP: npx -y resolve402-mcp, tool people_search (npm)
Agent guide: /llms.txt · skill: /SKILL.md

All services