search_company
Find VAT-registered French companies in the PPF directory by name or SIREN to verify e-invoicing eligibility and retrieve company details.
Instructions
Search for companies (legal units / SIRENs) in the PPF directory by criteria.
Returns VAT-registered French legal units recorded in the PPF directory. A company must appear here before its establishments (SIRETs) or directory lines can be used.
BEHAVIOR:
Returns a paginated list of matching companies; empty list if none match.
At least one search criterion must be provided; omitting all returns an error.
Name search is a partial, case-insensitive match against the legal name and trade name.
Pagination: if the response contains 'nextUpdatedAfter', pass it as updated_after to get the next page.
RESPONSE: each item includes siren, name, status (Active/Inactive/Pending), approvedPlatformId, and timestamps (createdAt, updatedAt).
USAGE GUIDELINES:
Prefer get_company_by_siren when you already know the exact SIREN (faster, direct lookup).
Use search_company with name to resolve a company name to its SIREN before further lookups.
Always check status == Active before attempting to send invoices to or look up establishments for a company.
A company not present in the directory is not yet registered for e-invoicing; invoices cannot be routed to it.
After finding the SIREN, call search_establishment or get_directory_line to find the recipient's address.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Company name or trade name (partial match accepted). Example: 'Dupont' returns all entities whose name contains 'Dupont'. Use when you know the name but not the SIREN. | |
| siren | No | Company SIREN number (9 digits, no spaces). Example: '123456789'. Use for an exact lookup; prefer get_company_by_siren when the SIREN is known. | |
| status | No | Registration status of the legal unit in the PPF directory. Active: registered and reachable for e-invoicing. Inactive: deregistered; cannot receive invoices. Pending: registration in progress. | |
| updated_after | No | Pagination cursor: only return entries updated after this date/time (ISO 8601, e.g. 2024-09-01T00:00:00Z). Use the 'nextUpdatedAfter' field from the previous response to fetch the next page. | |
| limit | No | Maximum number of results per page (1-500, default 50). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||