Skip to content

Seqino PDP API (1.0.0)

Seqino PDP API - Modern interface to France's e-Invoicing services

Download OpenAPI description
Languages
Servers
Dev server

https://pdp.seqino.dev/api/

Local development server

http://localhost:8052/

Operations
Operations

Request

Get all mandates for a client with their directory information.

Returns a list of mandates with their associated directory entries, including routing information and establishment details.

Query
status_filterMandateStatus (string) or Status Filter (null)(Status Filter)
Any of:

Status of the mandate.

string(MandateStatus)
Enum"created""pending_kyc""active""expired"
Headers
X-PDP-Client-Idstring(X-Pdp-Client-Id)required

ID of the PDP Client for which the operation is performed

Examples:
sandbox-client-seqino
curl -i -X GET \
  'https://pdp.seqino.dev/api/mandates?status_filter=created' \
  -H 'X-PDP-Client-Id: string'

Responses

List of client mandates

Bodyapplication/jsonArray [
idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
client_idstring(Client Id)required

Reference to the client who owns this mandate

start_datestring(date-time)(Start Date)required

When the mandate becomes active

end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
statusstring(MandateStatus)required
Enum"created""pending_kyc""active""expired"
directory_entryobject(DirectoryEntry)required
directory_entry.​sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

directory_entry.​namestring(Name)non-emptyrequired

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224"88"0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
created_atstring(date-time)(Created At)required

When the mandate was created

updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
]
Response
application/json
[ { "id": "string", "client_id": "string", "start_date": "2019-08-24T14:15:22Z", "end_date": "2019-08-24T14:15:22Z", "file_attachment": "string", "status": "created", "directory_entry": {}, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ]

📋 Create mandate with directory entry

Request

Create a new mandate with its associated directory entry.

This endpoint creates both:

  1. A directory entry for routing invoices to the company
  2. A mandate granting permission to manage invoices for this entity

The mandate defines the scope of operations the sponsor can perform for this legal entity (SIREN, SIRET, or routing code level).

Headers
X-PDP-Client-Idstring(X-Pdp-Client-Id)required

ID of the PDP Client for which the operation is performed

Examples:
sandbox-client-seqino
Bodyapplication/jsonrequired
start_datestring(date-time)(Start Date)required

When the mandate should become active

Example: "2024-01-15T00:00:00Z"
end_dateEnd Date (string) or End Date (null)(End Date)
Example: "2024-12-31T23:59:59Z"
Any of:

When the mandate should expire (optional)

string(date-time)(End Date)
directory_entryobject(DirectoryEntry)required
directory_entry.​sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

directory_entry.​namestring(Name)non-emptyrequired

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224"88"0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
curl -i -X POST \
  https://pdp.seqino.dev/api/mandates \
  -H 'Content-Type: application/json' \
  -H 'X-PDP-Client-Id: string' \
  -d '{
    "start_date": "2024-01-15T00:00:00Z",
    "end_date": "2024-12-31T23:59:59Z",
    "directory_entry": {
      "siren": "string",
      "name": "string",
      "suffix": "string",
      "siret": "string",
      "routing_identifier": "string",
      "routing_identifier_type": "0224",
      "routing_code_label": "string",
      "establishment_nature": "Private",
      "legal_commitment_management": true,
      "administrative_status": "A",
      "addressable": true,
      "address": {
        "address_line_1": "16 BIS RUE HENRI BARBUSSE",
        "address_line_2": "CEDEX 1",
        "address_line_3": "Bâtiment le Callipso",
        "postal_code": "38100",
        "subdivision": "Bretagne",
        "city": "Grenoble",
        "country_code": "FR"
      },
      "created_at": "2019-08-24",
      "updated_at": "2019-08-24"
    },
    "file_attachment": "string"
  }'

Responses

Mandate created successfully

Bodyapplication/json
mandateobject(Mandate)required
mandate.​idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
mandate.​client_idstring(Client Id)required

Reference to the client who owns this mandate

mandate.​start_datestring(date-time)(Start Date)required

When the mandate becomes active

mandate.​end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
mandate.​file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
mandate.​statusstring(MandateStatus)required
Enum"created""pending_kyc""active""expired"
mandate.​directory_entryobject(DirectoryEntry)required
mandate.​directory_entry.​sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

mandate.​directory_entry.​namestring(Name)non-emptyrequired

Company name

mandate.​directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
mandate.​directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
mandate.​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
mandate.​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224"88"0060""Internal"
mandate.​directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
mandate.​directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
mandate.​directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
mandate.​directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
mandate.​directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
mandate.​directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

mandate.​directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
mandate.​directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
mandate.​created_atstring(date-time)(Created At)required

When the mandate was created

mandate.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
messagestring(Message)required

Response message

Example: "Mandate created successfully"
Response
application/json
{ "mandate": { "id": "string", "client_id": "string", "start_date": "2019-08-24T14:15:22Z", "end_date": "2019-08-24T14:15:22Z", "file_attachment": "string", "status": "created", "directory_entry": {}, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }, "message": "Mandate created successfully" }

Request

Get detailed information about a specific mandate.

Path
mandate_idstring(Mandate Id)required

Mandate ID

Headers
X-PDP-Client-Idstring(X-Pdp-Client-Id)

ID of the PDP Client for which the operation is performed

Examples:
sandbox-client-seqino
curl -i -X GET \
  'https://pdp.seqino.dev/api/mandates/{mandate_id}' \
  -H 'X-PDP-Client-Id: string'

Responses

Mandate details

Bodyapplication/json
idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
client_idstring(Client Id)required

Reference to the client who owns this mandate

start_datestring(date-time)(Start Date)required

When the mandate becomes active

end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
statusstring(MandateStatus)required
Enum"created""pending_kyc""active""expired"
directory_entryobject(DirectoryEntry)required
directory_entry.​sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

directory_entry.​namestring(Name)non-emptyrequired

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224"88"0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
created_atstring(date-time)(Created At)required

When the mandate was created

updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
Response
application/json
{ "id": "string", "client_id": "string", "start_date": "2019-08-24T14:15:22Z", "end_date": "2019-08-24T14:15:22Z", "file_attachment": "string", "status": "created", "directory_entry": { "siren": "string", "name": "string", "suffix": "string", "siret": "string", "routing_identifier": "string", "routing_identifier_type": "0224", "routing_code_label": "string", "establishment_nature": "Private", "legal_commitment_management": true, "administrative_status": "A", "addressable": true, "address": {}, "created_at": "2019-08-24", "updated_at": "2019-08-24" }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }

Request

Revoke a mandate.

This action permanently deletes the mandate, revoking the sponsor's permission to manage invoices for this entity. The associated directory entry remains active but the sponsor can no longer perform operations on behalf of this entity.

Path
mandate_idstring(Mandate Id)required

Mandate ID

Headers
X-PDP-Client-Idstring(X-Pdp-Client-Id)required

ID of the PDP Client for which the operation is performed

Examples:
sandbox-client-seqino
curl -i -X DELETE \
  'https://pdp.seqino.dev/api/mandates/{mandate_id}' \
  -H 'X-PDP-Client-Id: string'

Responses

Mandate revoked successfully

Response
No content

Request

Create multiple mandates in a single batch operation.

This endpoint allows creating multiple mandates for a client at once, which is useful when onboarding clients with multiple entities or when importing existing mandate data.

All mandates in the batch will use the same client_id from the header. If any mandate fails to create, the entire batch will be rolled back.

Headers
X-PDP-Client-Idstring(X-Pdp-Client-Id)required

ID of the PDP Client for which the operation is performed

Examples:
sandbox-client-seqino
Bodyapplication/jsonrequired
mandatesArray of objects(Mandates)[ 1 .. 50 ] itemsrequired

List of mandates to create

mandates[].​start_datestring(date-time)(Start Date)required

When the mandate should become active

Example: "2024-01-15T00:00:00Z"
mandates[].​end_dateEnd Date (string) or End Date (null)(End Date)
Example: "2024-12-31T23:59:59Z"
Any of:

When the mandate should expire (optional)

string(date-time)(End Date)
mandates[].​directory_entryobject(DirectoryEntry)required
mandates[].​directory_entry.​sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

mandates[].​directory_entry.​namestring(Name)non-emptyrequired

Company name

mandates[].​directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
mandates[].​directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
mandates[].​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
mandates[].​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224"88"0060""Internal"
mandates[].​directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
mandates[].​directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
mandates[].​directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
mandates[].​directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
mandates[].​directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
mandates[].​directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

mandates[].​directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
mandates[].​directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
mandates[].​file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
curl -i -X POST \
  https://pdp.seqino.dev/api/mandates/batch \
  -H 'Content-Type: application/json' \
  -H 'X-PDP-Client-Id: string' \
  -d '{
    "mandates": [
      {
        "start_date": "2024-01-15T00:00:00Z",
        "end_date": "2024-12-31T23:59:59Z",
        "directory_entry": {
          "siren": "string",
          "name": "string",
          "suffix": "string",
          "siret": "string",
          "routing_identifier": "string",
          "routing_identifier_type": "0224",
          "routing_code_label": "string",
          "establishment_nature": "Private",
          "legal_commitment_management": true,
          "administrative_status": "A",
          "addressable": true,
          "address": {
            "address_line_1": "16 BIS RUE HENRI BARBUSSE",
            "address_line_2": "CEDEX 1",
            "address_line_3": "Bâtiment le Callipso",
            "postal_code": "38100",
            "subdivision": "Bretagne",
            "city": "Grenoble",
            "country_code": "FR"
          },
          "created_at": "2019-08-24",
          "updated_at": "2019-08-24"
        },
        "file_attachment": "string"
      }
    ]
  }'

Responses

Mandates created successfully

Bodyapplication/json
mandatesArray of objects(Mandates)required

Created mandates

mandates[].​idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
mandates[].​client_idstring(Client Id)required

Reference to the client who owns this mandate

mandates[].​start_datestring(date-time)(Start Date)required

When the mandate becomes active

mandates[].​end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
mandates[].​file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
mandates[].​statusstring(MandateStatus)required
Enum"created""pending_kyc""active""expired"
mandates[].​directory_entryobject(DirectoryEntry)required
mandates[].​directory_entry.​sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

mandates[].​directory_entry.​namestring(Name)non-emptyrequired

Company name

mandates[].​directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
mandates[].​directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
mandates[].​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
mandates[].​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224"88"0060""Internal"
mandates[].​directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
mandates[].​directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
mandates[].​directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
mandates[].​directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
mandates[].​directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
mandates[].​directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

mandates[].​directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
mandates[].​directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
mandates[].​created_atstring(date-time)(Created At)required

When the mandate was created

mandates[].​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
messagestring(Message)required

Success message

created_countinteger(Created Count)required

Number of mandates created

Response
application/json
{ "mandates": [ {} ], "message": "string", "created_count": 0 }

📘 Get directory entries for SIREN

Request

Get all directory/routing entries from the directory database for a given SIREN.

This endpoint retrieves routing information for a company identified by its SIREN. The data includes establishment details and routing configurations for electronic invoicing.

Path
sirenstring(Siren)required

Company SIREN number

Example: 123456789
Headers
X-PDP-Client-Idstring(X-Pdp-Client-Id)

ID of the PDP Client for which the operation is performed

Examples:
sandbox-client-seqino
curl -i -X GET \
  https://pdp.seqino.dev/api/mandates/directory/123456789 \
  -H 'X-PDP-Client-Id: string'

Responses

Directory entries found

Bodyapplication/jsonArray [
sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

namestring(Name)non-emptyrequired

Company name

suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224"88"0060""Internal"
routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
addressAddress (object) or null
Any of:

Address information for the establishment.

created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
]
Response
application/json
[ { "siren": "string", "name": "string", "suffix": "string", "siret": "string", "routing_identifier": "string", "routing_identifier_type": "0224", "routing_code_label": "string", "establishment_nature": "Private", "legal_commitment_management": true, "administrative_status": "A", "addressable": true, "address": {}, "created_at": "2019-08-24", "updated_at": "2019-08-24" } ]
Operations
Operations
Operations
Operations
Operations
Operations
Operations