---
updatedAt: 2025-06-16T22:59:09.000Z
---

Fetch the complete documentation index at: https://developers.neverbounce.com/llms.txt. Use this file to discover all available pages before exploring further.

# Job Callbacks

Job callbacks allow your application to react to status changes to your NeverBounce jobs. During [job creation](https://developers.neverbounce.com/reference/jobs-create)  you can specify a URL for us to send these callbacks to with the `callback_url`. You can also supply an array of request headers to send along with the callback in the `callback_headers` parameter.

The callbacks will be sent as a `POST` request with a JSON payload that contains an `event` and `job_id`. An example of the payload can be seen below.

```json Sample
{"job_id":4920062,"event":"job_deleted"}
```

Below is a list of the events that callbacks will be fired for.

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Event
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        job\_deleted
      </td>

      <td>
        Job is no longer available for verification or download
      </td>
    </tr>

    <tr>
      <td>
        job\_failed
      </td>

      <td>
        Job has failed is unable able to run, check failure reason in [/status](https://developers.neverbounce.com/reference/jobs-status).
      </td>
    </tr>

    <tr>
      <td>
        job\_parsing\_finished
      </td>

      <td>
        Job has completed the indexing phase.\
        If it the creation request used the `auto_start` parameter it will start momentarily; otherwise the job is now available to be started.
      </td>
    </tr>

    <tr>
      <td>
        job\_parsing\_started
      </td>

      <td>
        Job has begun it's indexing phase.
      </td>
    </tr>

    <tr>
      <td>
        job\_review\_completed
      </td>

      <td>
        Job has been released from it's manual review.
      </td>
    </tr>

    <tr>
      <td>
        job\_run\_finished
      </td>

      <td>
        Job has completed verification and results will be available for download via the [/download](https://developers.neverbounce.com/reference/jobs-download) or [/results](https://developers.neverbounce.com/reference/jobs-results) endpoint.
      </td>
    </tr>

    <tr>
      <td>
        job\_run\_started
      </td>

      <td>
        Job has begun the verification process. You can check the progress using the [/status](https://developers.neverbounce.com/reference/jobs-status) endpoint.
      </td>
    </tr>

    <tr>
      <td>
        job\_sample\_finished
      </td>

      <td>
        Job has finished the free analysis. You can check the stats using the [/status](https://developers.neverbounce.com/reference/jobs-status) endpoint.
      </td>
    </tr>

    <tr>
      <td>
        job\_sample\_started
      </td>

      <td>
        Job has begun it's free analysis.
      </td>
    </tr>

    <tr>
      <td>
        job\_stats\_updated
      </td>

      <td>
        Job has updated it's stats, they are available via the [/status](https://developers.neverbounce.com/reference/jobs-status) endpoint. This event will be sent frequently while a job is running.
      </td>
    </tr>
  </tbody>
</Table>