# Returns timeline activities for a specific document Retrieves timeline activities for a specific document including status changes, comments, and other events. Endpoint: GET /api/v3/{invoices-type}/{id}/timeline Version: 3.1.0 Security: apiKeyAuth ## Path parameters: - `invoices-type` (string, required) The type of the invoice document. receipts (payment receipts) is accepted here; receipts have no create, update, clone or /new (those operations use DocumentTypeInvoiceParam). Enum: "invoices", "invoice_receipts", "simplified_invoices", "credit_notes", "debit_notes", "receipts" - `id` (integer, required) The document ID. Example: 541674 ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Response 200 fields (application/json): - `timeline` (array) List of timeline activities and events for the document. Example: [{"id":2756411,"type":"Activity","event":"Created","author":"goncalo.correia@invoicexpress.com","message":{"data":{"author":"goncalo.correia@invoicexpress.com","auth_user":"goncalo.correia@rupeal.com"},"notification_type":"invoice"},"to":"goncalopcorreia@hotmail.com","date":"2026-07-27T16:00:44+01:00","can_change":false,"time_to_change":0},{"id":2756412,"type":"Activity","event":"Finalized","author":"goncalo.correia@invoicexpress.com","message":{"status":["draft","sent"],"sequence_number":["rascunho","110/INVOICEXPRESSDEMO"],"document_number":[null,"110"],"final_date":[null,"2026-07-27 17:23:50 +0100"]},"to":null,"date":"2026-07-27T17:23:50+01:00","can_change":false,"time_to_change":0}] - `timeline.id` (integer) - `timeline.type` (string) - `timeline.event` (string) Human-readable, translated label of the event (e.g. Created, Finalized, Comment), not a stable key. Do not branch on it; use type instead. - `timeline.author` (string) - `timeline.message` (object) Event-specific payload — the keys vary by event, so treat this as a free-form object. Created/Sent entries carry data.author, data.auth_user and notification_type; state-change entries such as Finalized instead carry [before, after] pairs for fields like status, sequence_number, document_number, document_serie, final_date, saft_hash, encrypted_doc, client_version and account_version; Paid entries carry total_paid and total_paid_before_taxes. - `timeline.message.data` (object) - `timeline.message.data.auth_user` (string) - `timeline.message.notification_type` (string) - `timeline.to` (string,null) - `timeline.date` (string) - `timeline.can_change` (boolean) - `timeline.time_to_change` (integer) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (array) Example: [{"error":"Resource not found"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)