# Batch Job event types

This is a list of all public [thin events](https://docs.stripe.com/event-destinations.md#thin-events) we currently send for updates to Batch Job, which are continually evolving and expanding. The payload of thin events is unversioned. During processing, you must fetch the versioned event from the API or fetch the resource’s current state.

## API event types

### `v2.core.batch_job.batch_failed`

Occurs when a batch job fails.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.batch_failed")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T11:00:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41a",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.batch_failed"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T11:00:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41a",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.batch_failed",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.canceled`

Occurs when a batch job is canceled.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.canceled")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T10:45:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41b",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.canceled"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T10:45:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41b",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.canceled",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.completed`

Occurs on completion of a batch job.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.completed")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T11:00:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40z",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.completed"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T11:00:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40z",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.completed",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.created`

Occurs on creation of a batch job.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.created")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T10:30:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40u",
  "livemode": true,
  "object": "v2.core.event",
  "reason": {
    "type": "request",
    "request": {
      "id": "req_v24sUK2aV6o01RdVU",
      "idempotency_key": "fe21992d-e123-3f8c-bc90-fec93712bcb2"
    }
  },
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.created"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T10:30:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40u",
  "livemode": true,
  "object": "v2.core.event",
  "reason": {
    "type": "request",
    "request": {
      "id": "req_v24sUK2aV6o01RdVU",
      "idempotency_key": "fe21992d-e123-3f8c-bc90-fec93712bcb2"
    }
  },
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.created",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.ready_for_upload`

Occurs on submission of a batch job.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.ready_for_upload")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T10:30:05.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40v",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.ready_for_upload"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T10:30:05.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40v",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.ready_for_upload",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.timeout`

Occurs when a batch job times out.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.timeout")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T22:30:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41c",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.timeout"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T22:30:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41c",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.timeout",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.updated`

Occurs when a batch job is updated.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.updated")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T10:50:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41d",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.updated"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T10:50:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K41d",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.updated",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.upload_timeout`

Occurs when merchant fails to upload a file in time.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.upload_timeout")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T11:30:05.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40w",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.upload_timeout"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T11:30:05.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40w",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.upload_timeout",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.validating`

Occurs when a batch job proceeds to the validation stage.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.validating")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T10:35:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40x",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.validating"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T10:35:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40x",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.validating",
  "changes": {},
  "data": {}
}
```

### `v2.core.batch_job.validation_failed`

Occurs when a batch job fails on validation.

Related object: [Batch Job](https://docs.stripe.com/api/v2/core/batch-jobs/object.md)

## Attributes

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

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

- `context` (string, nullable)
  Authentication context needed to fetch the event or related object.

- `created` (timestamp)
  Time at which the object 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.

- `related_object` (object)
  Object containing the reference to API resource relevant to the event.

  - `related_object.id` (string)
    Unique identifier for the object relevant to the event.

  - `related_object.type` (string, value is "v2.core.batch_job")
    Object tag of the resource relevant to the event.

  - `related_object.url` (string)
    URL to retrieve the resource.

- `type` (string, value is "v2.core.batch_job.validation_failed")
  The type of the event.

## Fetched attributes

- `changes` (null)
  Always `null` because this event type doesn’t track related object changes.

- `data` (object)
  Additional data about the event.

- `reason` (object, nullable)
  Reason for the event.

  - `reason.request` (object, nullable)
    Information on the API request that instigated the event.

    - `reason.request.id` (string)
      ID of the API request that caused the event.

    - `reason.request.idempotency_key` (string)
      The idempotency key transmitted during the request.

  - `reason.type` (enum)
    Event reason type.
Possible enum values:
    - `request`
      The event was published as the result of an API request.

### Event payload

```json
{
  "context": null,
  "created": "2025-01-15T10:36:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40y",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.validation_failed"
}
```

### Event handler

```curl
# Select a client library to see examples of
# parsing and retrieving event details.
```

### Fetched payload

```json
{
  "context": null,
  "created": "2025-01-15T10:36:00.000Z",
  "id": "evt_65RCjj4EqW1sabcjs2Z16RCMoNQdSQkOWvfL6L5uU2K40y",
  "livemode": true,
  "object": "v2.core.event",
  "reason": null,
  "related_object": {
    "id": "bj_1234567890abcdef",
    "type": "v2.core.batch_job",
    "url": "/v2/core/batch_jobs/bj_1234567890abcdef"
  },
  "type": "v2.core.batch_job.validation_failed",
  "changes": {},
  "data": {}
}
```