Ereignisse

Frage die Ereignisse ab, die Paperarchive aus Dokumenten extrahiert - Rechnungen, Verträge, Policen, Bescheide und mehr - inklusive Status, Betrag und Fälligkeit. Ideal für Fragen wie "Was ist offen oder fällig?".

GET https://api.paperarchive.io/v1/events

Scope:events:read

Listet aus Dokumenten extrahierte Ereignisse. Jedes Ereignis hat einen Status (z. B. "open", "paid", "active"), optional einen Betrag und eine Fälligkeit und verweist auf sein Quelldokument. Sichtbar sind Ereignisse, deren verknüpftes Dokument in einem zugänglichen Space liegt; Ereignisse ohne Dokument werden nicht zurückgegeben.

Query parameters

Name	Type	Required	Description
`state`	string	optional	Nach Status filtern: received, needs_input, open, paid, expired, cancelled, archived, active.
`event_type`	string	optional	Nach Typ filtern: invoice, offer, credit_note, statement, contract, policy, notice, receipt, payslip, letter.
`due_before`	date (YYYY-MM-DD)	optional	Nur Ereignisse mit Fälligkeit an oder vor diesem Datum.
`due_after`	date (YYYY-MM-DD)	optional	Nur Ereignisse mit Fälligkeit an oder nach diesem Datum.
`space_id`	uuid	optional	Nur Ereignisse, deren Dokument in diesem Space liegt.
`document_id`	uuid	optional	Nur Ereignisse zu diesem Dokument.
`limit`	integer	optional	Maximale Anzahl Ereignisse (1-100). Default: `25`
`offset`	integer	optional	Paginierungs-Offset. Default: `0`

Code examples

curl -X GET "https://api.paperarchive.io/v1/events?state=open&due_before=2026-09-30" \
  -H "Authorization: Bearer pa_live_abc123def456"

GET https://api.paperarchive.io/v1/events/:id

Scope:events:read

Ruft ein einzelnes Ereignis per ID ab - inklusive Beträgen, Fristen, Referenznummer, Absender und verknüpftem Quelldokument.

Path parameters

Name	Type	Required	Description
`id`	uuid	required	Die Ereignis-ID.

Code examples

curl -X GET "https://api.paperarchive.io/v1/events/e1f2a3b4-c5d6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer pa_live_abc123def456"