# Receiving Status Updates

To stay informed about the progress of dubbing processes, you can configure a callback URL.

For every status update related to an asset or its versions, Panjaya will send an HTTP  request to the specified URL.

Each update includes the following details:

* : The unique identifier for the asset. This field is always included.
* : The unique identifier for the version. This field is optional and is included only for
version-related events.
* : The target language of the version. This field is optional and is included only for version-related events.
*  specifies the type of event that occurred. Possible values are:
  * : An error occurred while processing the asset. In this case,  field will be .
  * : The version is ready for QC and additional editing in the workspace
  *  An error occurred during the dubbing process for this version.
  *  The version final video generation process has started.
  * : The version has been successfully generated. A URL to download the final video will be
  provided in the  field in Get Version endpoint.
  * : An error occurred during the video generation process.

### Signature verification
To ensure the authenticity of our callback requests, each request will include a signature in the  header.

The signature is calculated on the raw HTTP request's body, using the ES256 algorithm.

Optionally, you may use the  header to verify the authenticity of our request in your server.

Below is Panjaya's public key, to be used for verifying our callback's content:


And here's an example of how to verify the signature in Python:


Here's an example of the payload you can expect:

Endpoint: POST /callback

## Header parameters:

  - `X-Signature` (string, required)
    ES256 signature of the request body. Can be used to verify the authenticity of the request.

  - `X-Signature-Algorithm` (string)

## Request fields (application/json):

  - `event` (string, required)
    Enum: "asset_failed", "version_ready", "version_failed", "version_generating", "version_generated", "version_generate_failed"

  - `asset_id` (string, required)

  - `version_id` (any)

  - `version_locale` (any)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)