search_directory_line
Search for registered electronic invoice receiving addresses of a French taxable entity by SIREN, SIRET, or other criteria. Use to verify recipient registration and identify their approved platform before sending invoices.
Instructions
Search directory lines (electronic invoice receiving addresses) for a taxable entity.
A directory line maps an addressing identifier (SIREN, SIREN/SIRET, or SIREN/SIRET/routing-code) to an Approved Platform and an optional technical address. It is the authoritative record of where the recipient wants to receive invoices.
BEHAVIOR:
Returns a paginated list of matching directory lines; empty list if the entity has no registered lines.
At least one search criterion should be provided; omitting all may return an error or a very large result set.
Pagination: if the response contains 'nextUpdatedAfter', pass it as updated_after to retrieve the next page.
A recipient can have several lines (e.g. one at SIREN level plus specific ones per SIRET or routing code); the most specific line (SIREN/SIRET/routing-code) takes precedence over less specific ones.
RESPONSE: each item includes instanceId, addressingIdentifier (SIREN[/SIRET[/routingCode]]), approvedPlatformId, technicalAddress (optional), and timestamps (createdAt, updatedAt). The instanceId is required for update_directory_line and delete_directory_line.
USAGE GUIDELINES:
Prefer get_directory_line with the full addressingIdentifier when you know the exact address (faster, avoids pagination).
Use search_directory_line with siren to audit all receiving addresses of a company.
Call before sending an invoice to verify the recipient has a registered line and identify their AP.
If no lines are returned, the recipient is not yet registered in the PPF directory and cannot receive electronic invoices; they must register via create_directory_line or through their AP.
The instanceId from results is needed to call update_directory_line or delete_directory_line.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siren | No | Taxable entity SIREN (9 digits). Returns all directory lines (at SIREN, SIRET, and routing-code level) registered for this company. Most common starting point. | |
| siret | No | Specific establishment SIRET (14 digits). Narrows results to lines for this establishment only. | |
| routing_code | No | Filter by routing code associated with the directory line. Use to find the exact line for a department-level address. | |
| platform_id | No | Filter by Approved Platform identifier. Use to list all lines managed by a specific AP. | |
| updated_after | No | Pagination cursor: only return lines 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 | |||