Skip to main content

Check Conversion Status

Endpoint​

GET /v1/forms/convert/{job_id}/status

Description​

Polls a previously submitted flat → fillable conversion (created via POST /v1/forms/convert). While the job is running, it returns the converter status payload. When the job finishes, it also returns the converted PDF as a Base64 string plus the form_id that was created.

Request​

Path Parameter​

NameTypeRequiredDescription
job_idstringYesJob id returned by POST /v1/forms/convert.

Response​

Processing / pending / failed​

Status 200 with the downstream status payload:

{
  "status": "processing"
}

Completed​

Status 200 with the final payload:

{
  "status": "completed",
  "form_id": "675f5d197d9800b68b5c4c44",
  "base64": "JVBERi0xLjQKJ..." 
}

base64 is the converted fillable PDF. form_id is the id of the created form.

Errors​

If the downstream converter responds with a non-200 status, the API forwards that status code and returns:

{
  "error_message": "Error when fetching conversion status."
}