v1

latestOpenAPI 3.0.0Apache 2.02026-07-267057121.5 KB

Look up directory entries by SIREN

Returns all entries from the PPF Annuaire that match the given French SIREN. A company may have several entries so the response is always a list.

Only available to live workspaces. Sandbox workspaces receive 403 Forbidden.

get/apps/gov-fr/v1/directory/siren/{siren}

Path parameters

sirenstring required
Example:123456789

9-digit French SIREN identifier of the company to look up.

Response

Lookup completed. count may be 0 if the SIREN is not present in the directory.

sirenstring required

SIREN that was queried.

countinteger required

Number of directory entries returned.

Example response

{
  "siren": "123456789",
  "count": 1,
  "results": [
    {
      "id_instance": "1020993",
      "siren": "269909452",
      "routing_code": "ROUTE123",
      "platform_id": "0431",
      "nature": "M",
      "identifier": "269909452",
      "suffix": "suffixe1",
      "start_date": "20251227",
      "effective_end_date": "20280402",
      "created_at": "2026-01-15T10:00:00Z",
      "updated_at": "2026-01-15T10:00:00Z"
    }
  ]
}