search_directory_line
Search for electronic invoice receiving addresses of a company by SIREN, SIRET, or routing code. Returns paginated directory lines to verify recipient registration and identify their Approved Platform.
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 | |||