List workflow executions
Audit trail of Payment Link Automation runs (what ran, what was skipped, why), with stable reason codes; GET /v1/workflows explains each. Holds each workspace's newest five hundred runs (a few more for a moment when runs are written at once); older ones are removed as new ones are written. Email workflows record nothing here: an absent execution never means an email was not sent. Payment Arrangement tasks are listed by GET /v1/tasks. Cursor-paginated: pass limit (1–100) and send pagination.next_cursor back as cursor until has_more is false. To learn HOW MANY rows match without walking every page, pass include_total=true once and read pagination.total_count.
Available to admin and readonly API keys (no side effects).
Request
- Base URL: https://api.getfinero.com/functions/v1/api
- URL: https://api.getfinero.com/functions/v1/api/v1/workflow-executions
- Auth: HTTP bearer
Query parameters
Page size, 1–100. Default 25.
Opaque pagination cursor from a previous response's pagination.next_cursor.
Sort direction. Ordering is ALWAYS by when the record was CREATED in Finero, never by when it changed — updated_since narrows the set but does not reorder it, so the most recently updated row is not necessarily first. Creation time is immutable, which is what lets the cursor stay stable: ordering by a value that changes would move a row mid-walk and make a page skip or repeat it. Default desc (newest first by creation time).
Return pagination.total_count — the number of rows matching the filters, ignoring paging. It is the SAME number on every page, including alongside a cursor. Off by default: an exact count scans the whole filtered set, so asking on each page pays repeatedly for an answer that does not change — ask on the first request and keep it.
Filter by workflow type.
Filter by outcome.
Filter by invoice.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.