---
title: "List batch jobs"
method: GET
path: "/api/v1/batch-jobs"
tags: ["Batch Jobs"]
---

# List batch jobs

`GET /api/v1/batch-jobs`

List batch jobs with optional filtering by type and status.

## Query parameters

- `job_type` 'EVENT_CSV_IMPORT' | 'CUSTOMER_CSV_IMPORT' | 'SUBSCRIPTION_CSV_IMPORT' | 'SUBSCRIPTION_PLAN_MIGRATION'
- `status` string[]
- `page` integer
- `per_page` integer

## Response `200`

List of batch jobs

- BatchJobListResponse
  - `data` BatchJobResponse[], required
    - `completed_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `created_by` string, uuid, required
    - `failed_items` integer, required
    - `id` string, MeteroidId, required
    - `input_file_name` string, nullable
    - `job_type` 'EVENT_CSV_IMPORT' | 'CUSTOMER_CSV_IMPORT' | 'SUBSCRIPTION_CSV_IMPORT' | 'SUBSCRIPTION_PLAN_MIGRATION', required
    - `processed_items` integer, required
    - `status` 'PENDING' | 'CHUNKING' | 'PROCESSING' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS' | 'FAILED' | 'CANCELLED', required
    - `total_items` integer, nullable
  - `pagination_meta` PaginationResponse, required
    - `page` integer, required
    - `per_page` integer, required
    - `total_items` integer, required
    - `total_pages` integer, required

## Other responses

- `401` — Unauthorized
- `429` — Too many requests
- `500` — Internal error

---

[API](https://skmtc.net/meteroid-oss/apis/meteroid.md) · [All operations](https://skmtc.net/meteroid-oss/apis/meteroid/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meteroid-oss/meteroid/revisions/cf74b98b2838/schema)