Skip to main content

AFNOR Directory Service

The Directory Service API allows you to:

  • View and search for companies (SIREN)
  • View and search for establishments (SIRET)
  • View, and search for routing codes
  • View, and search for directory entries

Authentication: Each endpoint must be called with an access token (Bearer). This token is retrieved by a call to a token URL.

Siren​

Company by Siren number

  • POST /siren/search => Search for companies (legal unit) meeting all the criteria passed as parameters, potentially multiple results returned.
    • Request Body : { <search criteria in JSON format> }
      • filters : the list of filters to apply to the search.
      • sorting : sorting criteria by field with ascending or descending value.
      • fields : the list of fields expected in the response.
      • limit : the maximum number of results to return.
      • ignore : a number designating the offset to apply to the returned results. Useful for pagination.
    • Reponse : a paginated list of siren resources (legal unit).
  • GET /siren/code-insee:{siren} => Consult a siren (legal unit) identified by a siren passed as a parameter.
    • Mandatory parameter: a SIREN number.
    • Response : the details of a siren resource (legal unit).

Siret​

Facility by SIRET number

  • POST /siret/search => Search for establishments meeting all of the criteria passed as parameters, potentially returning multiple results.
    • Request body : { <search criteria in JSON format> }
      • filters: the list of filters to apply to the search.
      • sorting: sort criteria by field with ascending or descending value.
      • fields: the list of fields expected in the response.
      • include: the list of relationships (siren) to include in the returned results.
      • limit: the maximum number of results to return.
      • ignore: A number designating the offset to apply to the returned results. Useful for pagination.
    • Response : a paginated list of SIRET (facility) resources.
  • GET /siret/code-insee:{siret} => Get a SIRET (facility) identified by SIRET.
    • Mandatory parameter: a SIRET number.
    • Response : the details of a SIRET resource (facility).

Routing Code​

  • POST /routing-code/search => Search for routing codes that meet all the criteria passed as parameters, potentially returning multiple results.
    • Request body : { <search criteria in JSON format> }
      • filters: the list of filters to apply to the search.
      • sorting: sort criteria by field with ascending or descending value.
      • fields: the list of fields expected in the response.
      • limit: the maximum number of results to return
      • ignore: A number designating the offset to apply to the returned results. Useful for pagination.
    • Response : a paginated list of routing code resources.
  • GET /routing-code/siret:{siret}/code:{routing-identifier} => Consult the routing code identified by the SIRET and a routing identifier.
    • Mandatory parameter: the SIRET number of the routing code for which you wish to obtain details.
    • Mandatory parameter: the routing identifier for which you want to obtain details.
    • Response : the detail of a routing code.

Directory Line​

The directory line is the location at which the recipient wishes to receive his invoices (SIREN or SIREN/SIRET or SIREN/SIRET/routingIdentifier). The routing identifier can be a service code, a GLN 0224 code, an ODETTE 0088 code or an internal management code used by the recipient.

  • POST /directory-line/search => Search for directory lines that meet all the criteria passed as parameters, potentially returning multiple results.
    • Request body : { <search criteria in JSON format> }
      • filters: the list of filters to apply to the search.
      • sorting: sort criteria by field with ascending or descending value.
      • fields: the list of fields expected in the response.
      • limit: the maximum number of results to return
      • ignore: A number designating the offset to apply to the returned results. Useful for pagination.
    • Response : a paginated list of directory-line resources
  • GET /directory-line/code:{addressing-identifier} => Get a line in the directory identified by an address identifier.
    • Permissions : according to your permissions - Mandatory parameter: un identifiant addressage.
    • Response : the detail of a directory line.