# The Batch Job object

#### Complete

#### Complete

### The Batch Job object

```json
{
  "id": "batchv2_AbCdEfGhIjKlMnOpQrStUvWxYz",
  "object": "v2.core.batch_job",
  "created": "2026-03-09T20:55:31.000Z",
  "maximum_rps": 10,
  "metadata": {},
  "skip_validation": false,
  "status": "complete",
  "status_details": {
    "complete": {
      "output_file": {
        "content_type": "application/jsonlines",
        "download_url": {
          "expires_at": "2026-03-09T22:05:31.000Z",
          "url": "https://stripeusercontent.com/files/download/..."
        },
        "size": "8514"
      },
      "success_count": "100",
      "failure_count": "0"
    }
  }
}
```

#### Ready for upload

#### Ready for upload

### The Batch Job object

```json
{
  "id": "batchv2_AbCdEfGhIjKlMnOpQrStUvWxYz",
  "object": "v2.core.batch_job",
  "created": "2026-03-09T20:55:31.000Z",
  "maximum_rps": 10,
  "metadata": {},
  "skip_validation": false,
  "status": "ready_for_upload",
  "status_details": {
    "ready_for_upload": {
      "upload_url": {
        "expires_at": "2026-03-09T21:00:31.000Z",
        "url": "https://stripeusercontent.com/files/upload/..."
      }
    }
  }
}
```

#### In progress

#### In progress

### The Batch Job object

```json
{
  "id": "batchv2_AbCdEfGhIjKlMnOpQrStUvWxYz",
  "object": "v2.core.batch_job",
  "created": "2026-03-09T20:55:31.000Z",
  "maximum_rps": 10,
  "metadata": {},
  "skip_validation": false,
  "status": "in_progress",
  "status_details": {
    "in_progress": {
      "success_count": "45",
      "failure_count": "2"
    }
  }
}
```

## Attributes

- `id` (string)
  Unique identifier for the `batch_job`.

- `object` (string, value is "v2.core.batch_job")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `created` (timestamp)
  Timestamp at which the `batch_job` was created.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `maximum_rps` (integer)
  The maximum requests per second defined for the `batch_job`.

- `metadata` (map)
  The metadata of the `batch_job`.

- `skip_validation` (boolean)
  Whether validation runs before executing the `batch_job`.

- `status` (enum)
  The current status of the `batch_job`.
Possible enum values:
  - `batch_failed`
    The batch job failed to complete because of an error.

  - `canceled`
    The batch job was canceled.

  - `cancelling`
    The batch job is in the process of being canceled.

  - `complete`
    The batch job successfully finished.

  - `in_progress`
    Validation succeeded and the batch job is in progress.

  - `ready_for_upload`
    The batch job was initialized and the user can upload the input file now.

  - `timeout`
    The batch job timed out.

  - `upload_timeout`
    The input file wasn’t uploaded in time.

  - `validating`
    Input file was uploaded and validation is in progress.

  - `validation_failed`
    The batch job failed validation and was never processed.

- [`status_details`](https://docs.stripe.com/api/v2/core/batch-jobs/object.md?query=status_details) (object, nullable)
  Additional details about the current state of the `batch_job`.