Skip to content
/
📋 Update mandate

📋 Update mandate

Request

Update a mandate's end_date.

Allows patching the end_date of an existing mandate to extend or shorten its validity period. Set end_date to null to remove the expiry.

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:
Sandbox client
client_abc123
Bodyapplication/jsonrequired
end_datestring or null(End Date)
Any of:

When the mandate should expire (optional, set to null to remove expiry)

string (date-time)
curl -i -X PATCH \
  'https://pdp.seqino.dev/api/mandates/{mandate_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'X-PDP-Client-Id: client_abc123' \
  -d '{
    "end_date": "2024-12-31T23:59:59Z"
  }'

Responses

Mandate updated successfully

Bodyapplication/json
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. Note: if the requested start date is today or in the past, it will be updated with the real start date returned by the PPF once the status of the mandate becomes CREATED.

end_datestring or null(End Date)
Any of:

When the mandate expires. Optional: when omitted (null) the mandate never expires and stays active indefinitely. In the PPF directory an open-ended mandate maps to an effective end date of 9999-12-31. An expiry can be set or removed later via PATCH /mandates/{id}.

string (date-time)
file_attachmentstring or null(File Attachment)
Any of:

Optional file attachment for the mandate

string
statusstring(MandateStatus)required

Current status of the mandate

Enum:"processing""created""pending_kyb""active""expired""error""portability"
directory_entryobjectrequired

Directory entry information for the mandated entity

emit_onlyboolean(Emit Only)

Whether the mandate is only for emitting invoices

Default:false
vat_regimestring(VATRegime)

VAT regime of the mandated company. Determines data transmission periodicity.

Default:"real_normal_monthly"
Enum:"real_normal_monthly""real_normal_quarterly""simplified""franchise"
created_atstring, (date-time)(Created At)required

When the mandate was created

updated_atstring or null(Updated At)
Any of:

When the mandate was last updated

string (date-time)
error_causestring or null(Error Cause)
Any of:

Cause details in case of error.

string
idstring(Id)required

Unique mandate identifier

peppol_addressstring or null(Peppol Address)
Any of:

Peppol electronic address (for ACTIVE mandates only)

string
Response
{
  "client_id": "string",
  "start_date": "2019-08-24T14:15:22Z",
  "end_date": "2019-08-24T14:15:22Z",
  "file_attachment": "string",
  "status": "processing",
  "directory_entry": {},
  "emit_only": false,
  "vat_regime": "real_normal_monthly",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "error_cause": "string",
  "id": "string",
  "peppol_address": "string"
}