---
title: "GET /api/v1/batches"
method: GET
path: "/api/v1/batches"
---

# GET /api/v1/batches

`GET /api/v1/batches`

## Request

- Base URL: `https://12backlinks.com`
- URL: `https://12backlinks.com/api/v1/batches`
- Auth: HTTP bearer

List your latest batches, created through the API or the website (deleted ones excluded). Free.

## Query parameters

- `limit` integer: Number of batches, newest first. Default 20, maximum 50.

## Response `200`

Success.

- object
  - `batches` object[]
    - `batch_id` string
    - `name` string, nullable
    - `source` 'api' | 'ui'
    - `status` 'running' | 'done' | 'partial'
    - `created_at` string, date-time
    - `credits_charged` integer, nullable
    - `keywords` integer

## Other responses

- `400`: invalid_request: invalid input.
- `401`: unauthorized: missing, malformed or revoked API key.
- `404`: not_found: missing or not owned by this account.
- `500`: internal_error: unexpected error; retry later, mutations with the same idempotency_key.
- `503`: upstream_unavailable: retry later; mutations with the same idempotency_key.

---

[API](https://skmtc.dev/12backlinks/apis/12backlinks-api.md) · [All operations](https://skmtc.dev/12backlinks/apis/12backlinks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/12backlinks/apis/12backlinks-api/revisions/8936d132d496?raw)