Invoices

Get Invoice Timeline

Changed on

Retrieves the timeline of an invoice, oldest first: payment method selections and switches, payments, status changes and staff actions. The creation itself is the invoice's <code>created_at</code>. Invoices from before the timeline existed return an empty list.

get/v1/shops/{shopId}/invoices/{invoiceId}/events

Request

Response

Example response

{
  "data": [
    {
      "id": 1,
      "type": "gateway_selected",
      "actor": "customer",
      "user": null,
      "data": {
        "gateway": "LTC",
        "payment_method_id": 3,
        "payment_method_name": "Litecoin",
        "price": "10.00",
        "currency": "USD"
      },
      "created_at": "2026-10-08T12:00:00.000000Z"
    },
    {
      "id": 2,
      "type": "gateway_switched",
      "actor": "customer",
      "user": null,
      "data": {
        "from": {
          "gateway": "LTC",
          "payment_method_id": 3,
          "payment_method_name": "Litecoin"
        },
        "to": {
          "gateway": "STRIPE",
          "payment_method_id": 4,
          "payment_method_name": "Card"
        },
        "teardown": "unsupported"
      },
      "created_at": "2026-10-08T12:05:00.000000Z"
    }
  ]
}

Changes