VOvoiso
Tasks

Get job

Changed on

Returns detailed information about a specific job. The result field contains null until the job status is completed; its structure depends on the job type.

get/api/v4/tasks/jobs/{job_id}

Request

Path parameters

job_idstring uuid required
Example:7d8f1c2e-3b4a-4f5d-9e6c-1a2b3c4d5e6f

The unique identifier of the job.

Response

OK

Example response

{
  "job": {
    "id": "7d8f1c2e-3b4a-4f5d-9e6c-1a2b3c4d5e6f",
    "type": "bulk_conversation",
    "status": "completed",
    "reference": "spring-promo-2026",
    "created_at": "2026-01-15T10:30:00.123000Z",
    "updated_at": "2026-01-15T10:31:00.123000Z",
    "completed_at": "2026-01-15T10:31:00.123000Z",
    "result": {
      "cost": "14.40",
      "recipients": {
        "sent": [
          {
            "contact_channel_identifier": "15551234567",
            "conversation_id": "0b62763c-40d6-4ec8-8380-3cb94e442a75",
            "cost": "0.03",
            "errors": {
              "contact_channel_identifier": [
                "must be a valid phone number"
              ]
            }
          }
        ],
        "failed": [
          {
            "contact_channel_identifier": "15551234567",
            "conversation_id": "0b62763c-40d6-4ec8-8380-3cb94e442a75",
            "cost": "0.03",
            "errors": {
              "contact_channel_identifier": [
                "must be a valid phone number"
              ]
            }
          }
        ],
        "invalid": [
          {
            "contact_channel_identifier": "15551234567",
            "conversation_id": "0b62763c-40d6-4ec8-8380-3cb94e442a75",
            "cost": "0.03",
            "errors": {
              "contact_channel_identifier": [
                "must be a valid phone number"
              ]
            }
          }
        ]
      }
    }
  }
}

Changes