---
title: "List batches, V1 and V2 together"
method: GET
path: "/v2/einvoices/batches"
tags: ["jobs"]
---

# List batches, V1 and V2 together

`GET /v2/einvoices/batches`

## Request

- Base URL: `https://api.ironfang.com/finance`
- URL: `https://api.ironfang.com/finance/v2/einvoices/batches`
- Auth: HTTP bearer

A page of the organisation's batches, newest first, made through V1
or V2 (`api_version`). Pass `next_cursor` as `cursor` for the next
page. V1's own list shows V1 batches only.

## Query parameters

- `cursor` string
- `limit` integer
- `api_version` 'v1' | 'v2': The API a result was made through.

## Response `200`

The page. Cache-Control is no-store.

- BatchList
  - `batches` BatchSummary[], required
    - `api_version` 'v1' | 'v2', required: The API a result was made through.
    - `counts` JobCounts, required
      - `cancelled` integer, required
      - `completed` integer, required
      - `failed` integer, required
      - `queued` integer, required
      - `running` integer, required
    - `created_at` string, date-time, required
    - `id` string, required
    - `job_count` integer, required
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'partial', required: queued until a job starts; running while any is unfinished; then the one status every job shares, or partial.
  - `next_cursor` string
  - `schema` 'ironfang/finance/einvoice/batch-list/v2', required

## Other responses

- `400`: The request is malformed.
- `401`: The credential is missing or not accepted.
- `403`: The key lacks the scope this operation needs.
- `429`: Too many requests.
- `500`: Ironfang Finance failed. Not a verdict on anything.

---

[API](https://skmtc.dev/ironfang/apis/ironfang-finance-e-invoicing-api-2.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-finance-e-invoicing-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-finance-e-invoicing-api-2/revisions/8140667e556b?raw)