# Bulk

## Job Status Changed

`com.twilio.lookup.bulk.job-status-changed`

Bulk Job Status Changed events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts.

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.lookup.bulk.job-status-changed",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Lookup.BulkEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "twilio_error_code" : 60608,
    "job_sid" : "JW0000000000000000000000000000001",
    "friendly_name" : "Premium-accounts January 2025",
    "description" : "Customer Bulk Lookup January 2025- Premium accounts phone numbers",
    "created_at" : "2025-01-01T00:00:00.000Z",
    "completed_at" : "2025-01-01T00:01:00.000Z",
    "status" : "CREATED",
    "thresholds" : {
      "error" : 10
    },
    "result" : {
      "total_count" : 100,
      "processed_count" : 100,
      "success_count" : 100,
      "error_count" : 0,
      "file_url" : "https://lookup-bulk-service-bucket.s3.amazonaws.com/responses/AC0000000000000000000000000000001/JW0000000000000000000000000000001.csv.gz",
      "details" : "The job did not process all records due to insufficient funds. 25 records were skipped."
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `integer` **twilio\_error\_code**. Twilio error code. Only present for failed bulk executions.
* `string` **job\_sid** (required). Job SID from Bulk Job.
* `string` **friendly\_name**. Friendly name for the Bulk Job.
* `string` **description**. Description field of the Bulk Job.
* `string` **created\_at**. Creation date of the Bulk Job in ISO 8601 format.
* `string` **completed\_at**. Completion date of the Bulk Job in ISO 8601 format.
* `string` **status**. The status of the Bulk Job. Bulk Job processing status can be one of the following: CREATED, QUEUED, PROCESSING, COMPLETED, FAILED, CANCELED.
* `object` **thresholds**. Thresholds for the Bulk Job definition.
  * `number` **error** (required). The error threshold defined for the Bulk Job.
* `object` **result**. Result of the Bulk Job definition.
  * `integer` **total\_count** (required). Total count of requests in the Bulk Job.
  * `integer` **processed\_count** (required). Total count of requests processed in the Bulk Job.
  * `integer` **success\_count**. Success count of requests processed in the Bulk Job.
  * `integer` **error\_count**. Error count of the processed requests in the Bulk Job.
  * `string` **file\_url**. File Url for the result of the Bulk Job.
  * `string` **details**. An string containing information about the job execution.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Lookup.BulkEvent/2).

#### v1

* `integer` **twilio\_error\_code**. Twilio error code. Only present for failed bulk executions.
* `string` **job\_sid** (required). Job SID from Bulk Job.
* `string` **friendly\_name**. Friendly name for the Bulk Job.
* `string` **description**. Description field of the Bulk Job.
* `string` **created\_at**. Creation date of the Bulk Job in ISO 8601 format.
* `string` **completed\_at**. Completion date of the Bulk Job in ISO 8601 format.
* `string` **status**. The status of the Bulk Job. Bulk Job processing status can be one of the following: CREATED, QUEUED, PROCESSING, COMPLETED, FAILED, CANCELED.
* `object` **thresholds**. Thresholds for the Bulk Job definition.
  * `number` **error** (required). The error threshold defined for the Bulk Job.
* `object` **result**. Result of the Bulk Job definition.
  * `integer` **total\_count** (required). Total count of requests in the Bulk Job.
  * `integer` **processed\_count** (required). Total count of requests processed in the Bulk Job.
  * `integer` **success\_count**. Success count of requests processed in the Bulk Job.
  * `integer` **error\_count**. Error count of the processed requests in the Bulk Job.
  * `string` **file\_url**. File Url for the result of the Bulk Job.
  * `string` **details**. An string containing information about the job execution.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Lookup.BulkEvent/1).