Skip to content
/
📋 Create multiple mandat...

Seqino PDP API (1.0.0)

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

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL
https://pdp.seqino.dev/
Languages
Servers
Dev server
https://pdp.seqino.dev/api
Local development server
http://localhost:8052

👥 Clients

Operations

📋 Mandates

Operations

📋 Get client mandates

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.

Security
APIKeyHeader
Query
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"
Headers
X-PDP-Client-Idstring(X-Pdp-Client-Id)required

ID of the PDP Client for which the operation is performed

Examples:
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'

Responses

List of client mandates

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

Unique mandate identifier

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)

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

Current status of the mandate

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

Directory entry information for the mandated entity

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)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

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

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)
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)required

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)
smp_recipient_statusstring(SMPRecipientStatus)

Status of SMP recipient registration

Default "not_created"
Enum"not_created""pending""created""failed"
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)
]
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": "processing",
    "directory_entry": { … },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "smp_recipient_status": "not_created",
    "error_cause": "string"
  }
]

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

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

ID of the PDP Client for which the operation is performed

Examples:
client_abc123
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)

When the mandate should expire (optional)

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 information for the mandated entity

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)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

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

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)
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": "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"
      }
    },
    "file_attachment": "string"
  }'

Responses

Mandate created successfully

Bodyapplication/json
idstring(Id)required

Unique mandate identifier

client_idstring(Client Id)required

Reference to the client who owns this mandate

statusstring(MandateStatus)required

Current status of the mandate

Enum"processing""created""pending_kyc""active""expired""error"
directory_entryobject(BaseDirectoryEntry)required

Directory entry identification information for the mandated entity

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)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

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

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)
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)required

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)
Response
application/json
{
  "id": "string",
  "client_id": "string",
  "status": "processing",
  "directory_entry": {
    "siren": "string",
    "name": "string",
    "suffix": "string",
    "siret": "string",
    "routing_identifier": "string",
    "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

Request

Get detailed information about a specific mandate.

Security
APIKeyHeader
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:
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'

Responses

Mandate details

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

Unique mandate identifier

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)

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

Current status of the mandate

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

Directory entry information for the mandated entity

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)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

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

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)
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)required

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)
smp_recipient_statusstring(SMPRecipientStatus)

Status of SMP recipient registration

Default "not_created"
Enum"not_created""pending""created""failed"
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)
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": "processing",
  "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-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "smp_recipient_status": "not_created",
  "error_cause": "string"
}

📋 Revoke mandate

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.

Security
APIKeyHeader
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:
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'

Responses

Mandate revoked successfully

Response
No content

📋 Create multiple mandates

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.

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

ID of the PDP Client for which the operation is performed

Examples:
client_abc123
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)

When the mandate should expire (optional)

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

When the mandate should expire (optional)

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

Directory entry information for the mandated entity

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)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

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

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

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

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)
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": "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"
          }
        },
        "file_attachment": "string"
      }
    ]
  }'

Responses

Mandates created successfully

Bodyapplication/json
mandatesArray of objects(Mandates)required

Created mandates

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

Unique mandate identifier

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)

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

Current status of the mandate

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

Directory entry information for the mandated entity

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)

Service suffix - when using simple SIREN+suffix nomenclature

Any of:

Service suffix - when using simple SIREN+suffix nomenclature

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

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

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

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)
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)required

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[].​smp_recipient_statusstring(SMPRecipientStatus)

Status of SMP recipient registration

Default "not_created"
Enum"not_created""pending""created""failed"
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)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.

Security
APIKeyHeader
Path
sirenstring(Siren)required

Company SIREN number

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

Responses

Directory entries details

Bodyapplication/jsonArray [
sirenstring(Siren)non-emptyrequired

Company identification number (SIREN)

namestring(Name)non-emptyrequired

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)
siretSiret (string) or Siret (null)(Siret)

Establishment identification number (SIRET)

Any of:

Establishment identification number (SIRET)

string(Siret)
routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)

Routing identifier

Any of:

Routing identifier

string(Routing Identifier)
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.

]
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": { … }
  }
]

📝 Drafts

Operations

📘 Directory

Operations

🧾 Invoicing

Operations

🔄 Lifecycle

Operations

📊 Reporting

Operations

📊 Usage

Operations

⚙️ Settings

Operations

🔔 Webhooks

Operations

Health Check

Request

Health check endpoint.

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

Responses

Successful Response

Bodyapplication/json
any
Response
application/json
null