List Workflow Runs

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/?limit=100&document_packet_created_after=2026-07-17T00:00:00Z&document_packet_created_before=2026-07-18T00:00:00Z' \
  -H 'Authorization: Bearer YOUR_API_KEY'

# July 17 in Europe/Madrid = 2026-07-16T22:00:00Z .. 2026-07-17T22:00:00Z
curl --get 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/' \
  --data-urlencode 'limit=100' \
  --data-urlencode 'document_packet_created_after=2026-07-17T00:00:00+02:00' \
  --data-urlencode 'document_packet_created_before=2026-07-18T00:00:00+02:00' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"
url = f"https://api.anyformat.ai/v3/workflows/{workflow_id}/runs/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# All runs uploaded on 2026-07-17, paged.
# The cursor encodes pagination position only, NOT the filter — you must
# keep `document_packet_created_{after,before}` on every page or you will
# get runs from other upload days. Here we mutate the same `params` dict
# and just add `cursor`, so the filters ride along automatically.
params = {
    "limit": 100,
    "document_packet_created_after": "2026-07-17T00:00:00",
    "document_packet_created_before": "2026-07-18T00:00:00",
}
while True:
    page = requests.get(url, headers=headers, params=params).json()
    for run in page["items"]:
        print(run["id"], run["status"])
    if not page["next_cursor"]:
        break
    params["cursor"] = page["next_cursor"]

{
  "items": [
    {
      "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4fa",
      "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
      "status": "processed",
      "created_at": "2026-07-02T09:00:00.000Z",
      "updated_at": "2026-07-02T09:02:30.000Z"
    },
    {
      "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4f9",
      "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
      "status": "error",
      "created_at": "2026-07-01T12:00:00.000Z",
      "updated_at": "2026-07-01T12:01:10.000Z"
    }
  ],
  "next_cursor": null
}

GET

workflows

{workflow_id}

runs

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/?limit=100&document_packet_created_after=2026-07-17T00:00:00Z&document_packet_created_before=2026-07-18T00:00:00Z' \
  -H 'Authorization: Bearer YOUR_API_KEY'

# July 17 in Europe/Madrid = 2026-07-16T22:00:00Z .. 2026-07-17T22:00:00Z
curl --get 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/' \
  --data-urlencode 'limit=100' \
  --data-urlencode 'document_packet_created_after=2026-07-17T00:00:00+02:00' \
  --data-urlencode 'document_packet_created_before=2026-07-18T00:00:00+02:00' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"
url = f"https://api.anyformat.ai/v3/workflows/{workflow_id}/runs/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# All runs uploaded on 2026-07-17, paged.
# The cursor encodes pagination position only, NOT the filter — you must
# keep `document_packet_created_{after,before}` on every page or you will
# get runs from other upload days. Here we mutate the same `params` dict
# and just add `cursor`, so the filters ride along automatically.
params = {
    "limit": 100,
    "document_packet_created_after": "2026-07-17T00:00:00",
    "document_packet_created_before": "2026-07-18T00:00:00",
}
while True:
    page = requests.get(url, headers=headers, params=params).json()
    for run in page["items"]:
        print(run["id"], run["status"])
    if not page["next_cursor"]:
        break
    params["cursor"] = page["next_cursor"]

{
  "items": [
    {
      "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4fa",
      "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
      "status": "processed",
      "created_at": "2026-07-02T09:00:00.000Z",
      "updated_at": "2026-07-02T09:02:30.000Z"
    },
    {
      "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4f9",
      "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
      "status": "error",
      "created_at": "2026-07-01T12:00:00.000Z",
      "updated_at": "2026-07-01T12:01:10.000Z"
    }
  ],
  "next_cursor": null
}

Rate limit tier: general (600 req/min) — see Rate limits. Returns one keyset page of a workflow’s runs, newest first. Follow next_cursor until it is null (see Pagination). Items are slim — id, document_packet_id, status, timestamps. Fetch GET /v3/runs/{run_id}/ for the results envelope.

Filter by upload day

Two optional ISO 8601 datetime query params narrow the page to runs whose document packet was created inside a half-open interval [after, before):

document_packet_created_after — inclusive lower bound
document_packet_created_before — exclusive upper bound

Adjacent day-buckets tile without overlap: after=2026-07-17T00:00:00 & before=2026-07-18T00:00:00 returns exactly July 17. This is the intended shape for a daily-batch workflow (upload day N, cron enqueues runs, fetch results on day N+1). Timezones: both bounds accept any ISO 8601 offset (Z, +02:00, -05:00, …). Naive values (no offset) are interpreted as UTC. Use your local offset when “one day” means a day in your timezone — e.g. Madrid summer time (+02:00):

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/?limit=100&document_packet_created_after=2026-07-17T00:00:00Z&document_packet_created_before=2026-07-18T00:00:00Z' \
  -H 'Authorization: Bearer YOUR_API_KEY'

# July 17 in Europe/Madrid = 2026-07-16T22:00:00Z .. 2026-07-17T22:00:00Z
curl --get 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/runs/' \
  --data-urlencode 'limit=100' \
  --data-urlencode 'document_packet_created_after=2026-07-17T00:00:00+02:00' \
  --data-urlencode 'document_packet_created_before=2026-07-18T00:00:00+02:00' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"
url = f"https://api.anyformat.ai/v3/workflows/{workflow_id}/runs/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# All runs uploaded on 2026-07-17, paged.
# The cursor encodes pagination position only, NOT the filter — you must
# keep `document_packet_created_{after,before}` on every page or you will
# get runs from other upload days. Here we mutate the same `params` dict
# and just add `cursor`, so the filters ride along automatically.
params = {
    "limit": 100,
    "document_packet_created_after": "2026-07-17T00:00:00",
    "document_packet_created_before": "2026-07-18T00:00:00",
}
while True:
    page = requests.get(url, headers=headers, params=params).json()
    for run in page["items"]:
        print(run["id"], run["status"])
    if not page["next_cursor"]:
        break
    params["cursor"] = page["next_cursor"]

{
  "items": [
    {
      "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4fa",
      "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
      "status": "processed",
      "created_at": "2026-07-02T09:00:00.000Z",
      "updated_at": "2026-07-02T09:02:30.000Z"
    },
    {
      "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4f9",
      "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
      "status": "error",
      "created_at": "2026-07-01T12:00:00.000Z",
      "updated_at": "2026-07-01T12:01:10.000Z"
    }
  ],
  "next_cursor": null
}

Authorizations

Authorization

string

header

required

API key issued from app.anyformat.ai/api-key. Send as Authorization: Bearer <key>.

Path Parameters

workflow_id

string

required

Query Parameters

limit

integer

default:20

Page size, capped at 100.

Required range: 1 <= x <= 100

cursor

string | null

Opaque token from a previous response's next_cursor.

document_packet_created_after

string | null

Include only runs whose document packet was created at or after this ISO 8601 datetime (inclusive lower bound). Combine with document_packet_created_before to fetch one day's uploads.

document_packet_created_before

string | null

Include only runs whose document packet was created before this ISO 8601 datetime (exclusive upper bound). Adjacent day-buckets tile without overlap: after=2026-07-17T00:00:00 & before=2026-07-18T00:00:00 is exactly July 17.

Response

Successful Response

One keyset page of runs.

Fixed (-created_at, -id) order. No totals or page numbers — iterate by following next_cursor until it is null.

items

RunSummaryV3 · object[]

required

Runs on this page, newest first.

Show child attributes

next_cursor

string | null

Opaque token to fetch the next page; pass it back as ?cursor=. null on the last page.

Overview

Workflows

Upload

Document packets

Runs

Parse

Knowledge

Evals

SDKs and tools

API v2 (deprecated)

List Workflow Runs

Filter by upload day

Authorizations

Path Parameters

Query Parameters

Response

​Filter by upload day

Authorizations

Path Parameters

Query Parameters

Response

Filter by upload day