Passer au contenu

Seqino PDP API (1.0.0)

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

Télécharger la description d'OpenAPI
openapi.json
openapi.yaml
Aperçu
URL
https://pdp.seqino.dev/
Langues
Serveurs
Dev server
https://pdp.seqino.dev/api
Local development server
http://localhost:8052

👥 Clients

Opérations

📋 Mandates

Opérations

📋 Get client mandates

Requête

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.

Sécurité
APIKeyHeader
Requête
status_filterMandateStatus (string) or Status Filter (null)(Status Filter)

Filter by mandate status

Any of:

Status of the mandate.

string(MandateStatus)
Enum"processing""created""pending_kyc""active""expired""error"
En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Exemples:
client_abc123
curl -i -X GET \
  'https://pdp.seqino.dev/api/mandates?status_filter=processing' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Réponses

List of client mandates

Corpsapplication/jsonArray [
idId (string) or Id (null)(Id)

Unique mandate identifier

Any of:

Unique mandate identifier

string(Id)
client_idstring(Client Id)obligatoire

Reference to the client who owns this mandate

start_datestring(date-time)(Start Date)obligatoire

When the mandate becomes active

end_dateEnd Date (string) or End Date (null)(End Date)

When the mandate expires (optional)

Any of:

When the mandate expires (optional)

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

Optional file attachment for the mandate

Any of:

Optional file attachment for the mandate

string(File Attachment)
statusstring(MandateStatus)obligatoire

Current status of the mandate

Enum"processing""created""pending_kyc""active""expired""error"
directory_entryobject(DirectoryEntry)obligatoire

Directory entry information for the mandated entity

directory_entry.​sirenstring(Siren)^(\d{9}|([A-Z]{2})?\d{10})$obligatoire

Company identification number (SIREN or BCE number)

directory_entry.​namestring(Name)non-emptyobligatoire

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)^[-_.@a-zA-Z0-9]{1,100}$
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)^\d{14}$
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)^[-_/@a-zA-Z0-9]{1,100}$
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null

Type of routing identifier

Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)

Label for the routing code

Any of:

Label for the routing code

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

Nature of the establishment

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)

Legal commitment management status

Any of:

Legal commitment management status

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

Administrative status

Any of:

Administrative status of the establishment.

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

Whether the company is addressable

Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null

Establishment address

Any of:

Address information for the establishment.

created_atstring(date-time)(Created At)obligatoire

When the mandate was created

updated_atUpdated At (string) or Updated At (null)(Updated At)

When the mandate was last updated

Any of:

When the mandate was last updated

string(date-time)(Updated At)
error_causeError Cause (string) or Error Cause (null)(Error Cause)

Cause details in case of error.

Any of:

Cause details in case of error.

string(Error Cause)
]
Réponse
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": "processing",
    "directory_entry": { … },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "error_cause": "string"
  }
]

📋 Create mandate with directory entry

Requête

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).

Sécurité
APIKeyHeader
En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Exemples:
client_abc123
Corpsapplication/jsonobligatoire
start_datestring(date-time)(Start Date)obligatoire

When the mandate should become active

Exemple: "2024-01-15T00:00:00Z"
end_dateEnd Date (string) or End Date (null)(End Date)

When the mandate should expire (optional)

Exemple: "2024-12-31T23:59:59Z"
Any of:

When the mandate should expire (optional)

string(date-time)(End Date)
directory_entryobject(DirectoryEntry)obligatoire

Directory entry information for the mandated entity

directory_entry.​sirenstring(Siren)^(\d{9}|([A-Z]{2})?\d{10})$obligatoire

Company identification number (SIREN or BCE number)

directory_entry.​namestring(Name)non-emptyobligatoire

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)^[-_.@a-zA-Z0-9]{1,100}$
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)^\d{14}$
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)^[-_/@a-zA-Z0-9]{1,100}$
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null

Type of routing identifier

Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)

Label for the routing code

Any of:

Label for the routing code

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

Nature of the establishment

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)

Legal commitment management status

Any of:

Legal commitment management status

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

Administrative status

Any of:

Administrative status of the establishment.

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

Whether the company is addressable

Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null

Establishment address

Any of:

Address information for the establishment.

file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)

Optional file attachment for the mandate

Any of:

Optional file attachment for the mandate

string(File Attachment)
curl -i -X POST \
  https://pdp.seqino.dev/api/mandates \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -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": "123456789",
      "name": "string",
      "suffix": "Administration",
      "siret": "12345678901234",
      "routing_identifier": "GLN_987654321",
      "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"
      }
    },
    "file_attachment": "string"
  }'

Réponses

Mandate created successfully

Corpsapplication/json
idstring(Id)obligatoire

Unique mandate identifier

client_idstring(Client Id)obligatoire

Reference to the client who owns this mandate

statusstring(MandateStatus)obligatoire

Current status of the mandate

Enum"processing""created""pending_kyc""active""expired""error"
start_datestring(date-time)(Start Date)obligatoire

When the mandate should become active

Exemple: "2024-01-15T00:00:00Z"
end_dateEnd Date (string) or End Date (null)(End Date)

When the mandate should expire (optional)

Exemple: "2024-12-31T23:59:59Z"
Any of:

When the mandate should expire (optional)

string(date-time)(End Date)
directory_entryobject(BaseDirectoryEntry)obligatoire

Directory entry identification information for the mandated entity

directory_entry.​sirenstring(Siren)^(\d{9}|([A-Z]{2})?\d{10})$obligatoire

Company identification number (SIREN or BCE number)

directory_entry.​namestring(Name)non-emptyobligatoire

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)^[-_.@a-zA-Z0-9]{1,100}$
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)^\d{14}$
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)^[-_/@a-zA-Z0-9]{1,100}$
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null

Type of routing identifier

Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)

Label for the routing code

Any of:

Label for the routing code

string(Routing Code Label)
created_atstring(date-time)(Created At)obligatoire

When the mandate was created

updated_atUpdated At (string) or Updated At (null)(Updated At)

When the mandate was last updated

Any of:

When the mandate was last updated

string(date-time)(Updated At)
error_causeError Cause (string) or Error Cause (null)(Error Cause)

Cause details in case of error.

Any of:

Cause details in case of error.

string(Error Cause)
Réponse
application/json
{
  "id": "string",
  "client_id": "string",
  "status": "processing",
  "start_date": "2024-01-15T00:00:00Z",
  "end_date": "2024-12-31T23:59:59Z",
  "directory_entry": {
    "siren": "123456789",
    "name": "string",
    "suffix": "Administration",
    "siret": "12345678901234",
    "routing_identifier": "GLN_987654321",
    "routing_identifier_type": "0224",
    "routing_code_label": "string"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "error_cause": "string"
}

📋 Get mandate details

Requête

Get detailed information about a specific mandate.

Sécurité
APIKeyHeader
Chemin
mandate_idstring(Mandate Id)obligatoire

Mandate ID

En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Exemples:
client_abc123
curl -i -X GET \
  'https://pdp.seqino.dev/api/mandates/{mandate_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Réponses

Mandate details

Corpsapplication/json
idId (string) or Id (null)(Id)

Unique mandate identifier

Any of:

Unique mandate identifier

string(Id)
client_idstring(Client Id)obligatoire

Reference to the client who owns this mandate

start_datestring(date-time)(Start Date)obligatoire

When the mandate becomes active

end_dateEnd Date (string) or End Date (null)(End Date)

When the mandate expires (optional)

Any of:

When the mandate expires (optional)

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

Optional file attachment for the mandate

Any of:

Optional file attachment for the mandate

string(File Attachment)
statusstring(MandateStatus)obligatoire

Current status of the mandate

Enum"processing""created""pending_kyc""active""expired""error"
directory_entryobject(DirectoryEntry)obligatoire

Directory entry information for the mandated entity

directory_entry.​sirenstring(Siren)^(\d{9}|([A-Z]{2})?\d{10})$obligatoire

Company identification number (SIREN or BCE number)

directory_entry.​namestring(Name)non-emptyobligatoire

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)^[-_.@a-zA-Z0-9]{1,100}$
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)^\d{14}$
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)^[-_/@a-zA-Z0-9]{1,100}$
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null

Type of routing identifier

Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)

Label for the routing code

Any of:

Label for the routing code

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

Nature of the establishment

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)

Legal commitment management status

Any of:

Legal commitment management status

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

Administrative status

Any of:

Administrative status of the establishment.

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

Whether the company is addressable

Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null

Establishment address

Any of:

Address information for the establishment.

created_atstring(date-time)(Created At)obligatoire

When the mandate was created

updated_atUpdated At (string) or Updated At (null)(Updated At)

When the mandate was last updated

Any of:

When the mandate was last updated

string(date-time)(Updated At)
error_causeError Cause (string) or Error Cause (null)(Error Cause)

Cause details in case of error.

Any of:

Cause details in case of error.

string(Error Cause)
Réponse
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": "processing",
  "directory_entry": {
    "siren": "123456789",
    "name": "string",
    "suffix": "Administration",
    "siret": "12345678901234",
    "routing_identifier": "GLN_987654321",
    "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-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "error_cause": "string"
}

📋 Revoke mandate

Requête

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.

Sécurité
APIKeyHeader
Chemin
mandate_idstring(Mandate Id)obligatoire

Mandate ID

En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Exemples:
client_abc123
curl -i -X DELETE \
  'https://pdp.seqino.dev/api/mandates/{mandate_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Réponses

Mandate revoked successfully

Réponse
Aucun contenu

📋 Create multiple mandates

Requête

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.

Sécurité
APIKeyHeader
En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Exemples:
client_abc123
Corpsapplication/jsonobligatoire
mandatesArray of objects(Mandates)[ 1 .. 50 ] itemsobligatoire

List of mandates to create

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

When the mandate should become active

Exemple: "2024-01-15T00:00:00Z"
mandates[].​end_dateEnd Date (string) or End Date (null)(End Date)

When the mandate should expire (optional)

Exemple: "2024-12-31T23:59:59Z"
Any of:

When the mandate should expire (optional)

string(date-time)(End Date)
mandates[].​directory_entryobject(DirectoryEntry)obligatoire

Directory entry information for the mandated entity

mandates[].​directory_entry.​sirenstring(Siren)^(\d{9}|([A-Z]{2})?\d{10})$obligatoire

Company identification number (SIREN or BCE number)

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

Company name

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

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)^[-_.@a-zA-Z0-9]{1,100}$
mandates[].​directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)^\d{14}$
mandates[].​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)^[-_/@a-zA-Z0-9]{1,100}$
mandates[].​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null

Type of routing identifier

Any of:

Type of routing identifier.

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

Label for the routing code

Any of:

Label for the routing code

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

Nature of the establishment

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)

Legal commitment management status

Any of:

Legal commitment management status

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

Administrative status

Any of:

Administrative status of the establishment.

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

Whether the company is addressable

Any of:

Whether the company is addressable

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

Establishment address

Any of:

Address information for the establishment.

mandates[].​file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)

Optional file attachment for the mandate

Any of:

Optional file attachment for the mandate

string(File Attachment)
curl -i -X POST \
  https://pdp.seqino.dev/api/mandates/batch \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -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": "123456789",
          "name": "string",
          "suffix": "Administration",
          "siret": "12345678901234",
          "routing_identifier": "GLN_987654321",
          "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"
          }
        },
        "file_attachment": "string"
      }
    ]
  }'

Réponses

Mandates created successfully

Corpsapplication/json
mandatesArray of objects(Mandates)obligatoire

Created mandates

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

Unique mandate identifier

Any of:

Unique mandate identifier

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

Reference to the client who owns this mandate

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

When the mandate becomes active

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

When the mandate expires (optional)

Any of:

When the mandate expires (optional)

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

Optional file attachment for the mandate

Any of:

Optional file attachment for the mandate

string(File Attachment)
mandates[].​statusstring(MandateStatus)obligatoire

Current status of the mandate

Enum"processing""created""pending_kyc""active""expired""error"
mandates[].​directory_entryobject(DirectoryEntry)obligatoire

Directory entry information for the mandated entity

mandates[].​directory_entry.​sirenstring(Siren)^(\d{9}|([A-Z]{2})?\d{10})$obligatoire

Company identification number (SIREN or BCE number)

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

Company name

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

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)^[-_.@a-zA-Z0-9]{1,100}$
mandates[].​directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)^\d{14}$
mandates[].​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)^[-_/@a-zA-Z0-9]{1,100}$
mandates[].​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null

Type of routing identifier

Any of:

Type of routing identifier.

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

Label for the routing code

Any of:

Label for the routing code

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

Nature of the establishment

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)

Legal commitment management status

Any of:

Legal commitment management status

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

Administrative status

Any of:

Administrative status of the establishment.

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

Whether the company is addressable

Any of:

Whether the company is addressable

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

Establishment address

Any of:

Address information for the establishment.

mandates[].​created_atstring(date-time)(Created At)obligatoire

When the mandate was created

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

When the mandate was last updated

Any of:

When the mandate was last updated

string(date-time)(Updated At)
mandates[].​error_causeError Cause (string) or Error Cause (null)(Error Cause)

Cause details in case of error.

Any of:

Cause details in case of error.

string(Error Cause)
messagestring(Message)obligatoire

Success message

created_countinteger(Created Count)obligatoire

Number of mandates created

Réponse
application/json
{
  "mandates": [
    { … }
  ],
  "message": "string",
  "created_count": 0
}

📘 Get directory entries for SIREN

Requête

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.

Sécurité
APIKeyHeader
Chemin
sirenstring(Siren)obligatoire

Company SIREN number

curl -i -X GET \
  'https://pdp.seqino.dev/api/mandates/directory/{siren}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Réponses

Directory entries details

Corpsapplication/jsonArray [
sirenstring(Siren)^(\d{9}|([A-Z]{2})?\d{10})$obligatoire

Company identification number (SIREN or BCE number)

namestring(Name)non-emptyobligatoire

Company name

suffixSuffix (string) or Suffix (null)(Suffix)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)^[-_.@a-zA-Z0-9]{1,100}$
siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)^\d{14}$
routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)^[-_/@a-zA-Z0-9]{1,100}$
routing_identifier_typeRoutingIdentifierType (string) or null

Type of routing identifier

Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)

Label for the routing code

Any of:

Label for the routing code

string(Routing Code Label)
establishment_natureEstablishmentNature (string) or null

Nature of the establishment

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)

Legal commitment management status

Any of:

Legal commitment management status

boolean(Legal Commitment Management)
administrative_statusAdministrativeStatus (string) or null

Administrative status

Any of:

Administrative status of the establishment.

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

Whether the company is addressable

Any of:

Whether the company is addressable

boolean(Addressable)
addressAddress (object) or null

Establishment address

Any of:

Address information for the establishment.

]
Réponse
application/json
[
  {
    "siren": "123456789",
    "name": "string",
    "suffix": "Administration",
    "siret": "12345678901234",
    "routing_identifier": "GLN_987654321",
    "routing_identifier_type": "0224",
    "routing_code_label": "string",
    "establishment_nature": "Private",
    "legal_commitment_management": true,
    "administrative_status": "A",
    "addressable": true,
    "address": { … }
  }
]

📝 Drafts

Opérations

📘 Directory

Opérations

🧾 Invoicing

Opérations

🔄 Lifecycle

Opérations

📊 Reporting

Opérations

📊 Usage

Opérations

⚙️ Settings

Opérations

🔔 Webhooks

Opérations
Webhooks

Health Check

Requête

Health check endpoint.

curl -i -X GET \
  https://pdp.seqino.dev/health

Réponses

Successful Response

Corpsapplication/json
any
Réponse
application/json
null