Skip to content

🔄 Lifecycle

Polls or subscribes to lifecycle events

Operations

📊 Get lifecycle events

Request

Get lifecycle events with optional filtering.

  • Without parameters: Returns all lifecycle events for the PDP client
  • With object_type only: Returns all events for that object type
  • With both parameters: Returns events for a specific object

Use invoice for both structured and exempt invoices.

Security
APIKeyHeader
Query
object_typestring(ObjectType)

Filter by object type

Enum:"invoice""mandate""directory_entry""regulatory_data""flow""transaction_data""lifecycle_status"
object_idstring(Object Id)

Filter by object 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
curl -i -X GET \
  'https://pdp.seqino.dev/api/lifecycle-events?object_type=invoice&object_id=string' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: client_abc123'

Responses

Successful Response

Bodyapplication/json
Array [
status_codestring(LifecycleStatusCode)required

Unified lifecycle status codes for all object types.

Enum:"InvoiceLifecycleStatus.DEPOSITED""InvoiceLifecycleStatus.TRANSMITTED_BY_PLATFORM""InvoiceLifecycleStatus.RECEIVED_BY_PLATFORM""InvoiceLifecycleStatus.MADE_AVAILABLE""InvoiceLifecycleStatus.ACKNOWLEDGED""InvoiceLifecycleStatus.APPROVED""InvoiceLifecycleStatus.PARTIALLY_APPROVED""InvoiceLifecycleStatus.IN_DISPUTE""InvoiceLifecycleStatus.SUSPENDED""InvoiceLifecycleStatus.COMPLETED"
timestampstring, (date-time)(Timestamp)required
emitterstring(Emitter)required

Platform or system that emitted the status

reasonstring or null(Reason)
Any of:

Optional free-text reason or comment

string
rejection_reasonstring or null(Rejection Reason)
Any of:

Structured rejection reason code when status indicates rejection

string
is_mandatoryboolean(Is Mandatory)

Whether this status must be reported to PPF within 24 hours

Default:false
]
Response
[
  {
    "status_code": "InvoiceLifecycleStatus.DEPOSITED",
    "timestamp": "2019-08-24T14:15:22Z",
    "emitter": "PDPE",
    "reason": "string",
    "rejection_reason": "string",
    "is_mandatory": false
  }
]