---
title: "Get job"
method: GET
path: "/api/v4/tasks/jobs/{job_id}"
tags: ["Tasks"]
---

# Get job

`GET /api/v4/tasks/jobs/{job_id}`

## Request

- Base URL: `https://{cluster_id}.voiso.com`
- URL: `https://{cluster_id}.voiso.com/api/v4/tasks/jobs/{job_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/voiso/apis/voiso-api/docs/api/v4/tasks/jobs/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `job_id` string, uuid, required

## Response `200`

OK

- object
  - `job` Job: An asynchronous job created via the API.
    - `id` string, uuid: The unique identifier of the job.
    - `type` 'bulk_conversation': The job type. Defines the structure of the result.
    - `status` 'pending' | 'processing' | 'completed': The current status of the job.
    - `reference` string, nullable: The client-assigned reference from the originating request.
    - `created_at` string, date-time: Timestamp when the job was created (ISO 8601).
    - `updated_at` string, date-time: Timestamp when the job was last updated (ISO 8601).
    - `completed_at` string, date-time, nullable: Timestamp when the job was completed (ISO 8601).
    - `result` BulkConversationResult: Result of a bulk conversation creation job.
      - `cost` string: Total amount charged for the job.
      - `recipients` object: Recipients of the bulk send, grouped by outcome.
        - `sent` BulkConversationResultRecipient[]: Recipients whose message was accepted by the gateway.
          - `contact_channel_identifier` string: Channel-specific identifier of the contact (phone number for WhatsApp).
          - `conversation_id` string, uuid, nullable: The unique identifier of the conversation, when one exists for the recipient.
          - `cost` string: Amount charged for the message sent to the recipient.
          - `errors` object, nullable: A set of error messages. Validation errors are keyed by the request property; other errors use the `base` key.
        - `failed` BulkConversationResultRecipient[]: Recipients whose message could not be sent.
          - `contact_channel_identifier` string: Channel-specific identifier of the contact (phone number for WhatsApp).
          - `conversation_id` string, uuid, nullable: The unique identifier of the conversation, when one exists for the recipient.
          - `cost` string: Amount charged for the message sent to the recipient.
          - `errors` object, nullable: A set of error messages. Validation errors are keyed by the request property; other errors use the `base` key.
        - `invalid` BulkConversationResultRecipient[]: Recipients that were rejected by validation. No message was sent.
          - `contact_channel_identifier` string: Channel-specific identifier of the contact (phone number for WhatsApp).
          - `conversation_id` string, uuid, nullable: The unique identifier of the conversation, when one exists for the recipient.
          - `cost` string: Amount charged for the message sent to the recipient.
          - `errors` object, nullable: A set of error messages. Validation errors are keyed by the request property; other errors use the `base` key.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Too many requests

## Changes

- **2026-11-03** `5a6ea146bd21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voiso/apis/voiso-api/changes/api/v4/tasks/jobs/:job_id/get.md)

---

[API](https://skmtc.dev/voiso/apis/voiso-api.md) - [All operations](https://skmtc.dev/voiso/apis/voiso-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voiso/apis/voiso-api/revisions/5a6ea146bd21?raw)