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. Keep
# `document_packet_created_{after,before}` on every page, or the next page
# returns runs from other upload days. Mutating the same `params` dict and
# adding `cursor` carries the filters 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. Keep
# `document_packet_created_{after,before}` on every page, or the next page
# returns runs from other upload days. Mutating the same `params` dict and
# adding `cursor` carries the filters 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 requests/min. See Rate limits. Returns one keyset page of a workflow’s runs, newest first. Follow next_cursor until it is null. See Pagination. Each item is slim: id, document_packet_id, status and timestamps. For the results envelope, fetch GET /v3/runs/{run_id}/.

Filter by upload day

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

document_packet_created_after is the inclusive lower bound.
document_packet_created_before is the 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. That is the shape a daily-batch workflow wants: upload on day N, let cron enqueue the runs, fetch the results on day N+1. Timezones. Both bounds accept any ISO 8601 offset, such as Z, +02:00 or -05:00. A value with no offset counts as UTC. Use your local offset when “one day” means a day in your timezone. The examples below cover UTC and Madrid summer time.

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. Keep
# `document_packet_created_{after,before}` on every page, or the next page
# returns runs from other upload days. Mutating the same `params` dict and
# adding `cursor` carries the filters 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

Splits

Parse

Knowledge

Evals

SDKs and tools

API v2 (retired)

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