Case Timelines#

Case Timelines provide a chronological event log for each collection case. Every significant action — from submission to resolution — is recorded.

The Timeline Entry object#

Attribute	Type	Description
`date`	timestamp	Event time (Unix timestamp)
`type`	string	Event type identifier
`title`	string	Short description
`description`	string	Full details

Timeline Event Types#

Type	Description
`case_created`	Case was submitted
`case_assigned`	Case assigned to collection partner
`demand_letter_sent`	Demand letter sent to debtor
`debtor_contacted`	Partner contacted the debtor
`payment_received`	Partial or full payment received
`payment_plan_agreed`	Payment plan negotiated
`legal_action_initiated`	Legal proceedings started
`case_paused`	Case temporarily paused
`case_resumed`	Case resumed
`case_closed`	Case closed

{
  "data": [
    {
      "date": 1706140800,
      "type": "case_created",
      "title": "Case submitted",
      "description": "Collection case created and assigned to CollectMax GmbH"
    },
    {
      "date": 1706227200,
      "type": "demand_letter_sent",
      "title": "Demand letter sent",
      "description": "First demand letter sent to debtor via registered mail"
    },
    {
      "date": 1706832000,
      "type": "debtor_contacted",
      "title": "Debtor contacted",
      "description": "Phone contact with debtor. Debtor acknowledged the debt."
    },
    {
      "date": 1707436800,
      "type": "payment_plan_agreed",
      "title": "Payment plan agreed",
      "description": "Debtor agreed to pay €120/month for 3 months starting February 15"
    }
  ]
}

List Timeline Entries#

GET /v1/collection_cases/:id/timeline

curl https://api.casapay.com/v1/collection_cases/dc_a1b2c3d4/timeline \
  -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc"