---
title: "Get Async Task Status"
method: GET
path: "/ai/status/v1/jobs/{jobId}"
tags: ["Status"]
---

# Get Async Task Status

`GET /ai/status/v1/jobs/{jobId}`

Returns async task status by Job ID

## Path parameters

- `jobId` string, uuid, required

## Response `200`

Successful response

- union
  - object
    - `jobId` string
    - `creationTime` string, date-time
    - `completionTime` string, date-time
    - `expirationTime` string, date-time
    - `status` 'Success' | 'Fail'
    - `response` union
      - SummaryOutput
        - `summaries` SummaryOutputUnit[]
          - `name` 'Extractive' | 'AbstractiveLong' | 'AbstractiveShort' | 'All'
          - `values` SummaryTimingsUnit[] — Summary output units sorted by their occurrence in the conversation
            - `confidence` number, float
            - `value` string, required
            - `start` number, float
            - `end` number, float
      - CaiErrorResponse
        - `errors` CaiErrorCodeResponse[]
          - `errorCode` 'CAI-101' | 'CAI-102' | 'CAI-103' | 'CAI-104' | 'CAI-105' | 'CAI-106' | 'CAI-107' | 'CAI-108' | 'CAI-109' | 'CAI-110', required
          - `message` string, required — Helpful description of the errorCode
          - `parameterName` string — Name of parameter if specified in the message
  - object
    - `jobId` string
    - `creationTime` string, date-time
    - `completionTime` string, date-time
    - `expirationTime` string, date-time
    - `status` 'Success' | 'Fail'
    - `response` union
      - PunctuateOutput
        - `texts` string[], required
      - CaiErrorResponse
        - `errors` CaiErrorCodeResponse[]
          - `errorCode` 'CAI-101' | 'CAI-102' | 'CAI-103' | 'CAI-104' | 'CAI-105' | 'CAI-106' | 'CAI-107' | 'CAI-108' | 'CAI-109' | 'CAI-110', required
          - `message` string, required — Helpful description of the errorCode
          - `parameterName` string — Name of parameter if specified in the message
  - object
    - `jobId` string
    - `creationTime` string, date-time
    - `completionTime` string, date-time
    - `expirationTime` string, date-time
    - `status` 'Success' | 'Fail'
    - `response` union
      - DiarizedObject
        - `speakerCount` integer, required
        - `utterances` DiarizeSegment[], required
          - `speakerId` string, required
          - `start` number, float, required
          - `end` number, float, required
          - `confidence` number, float
      - CaiErrorResponse
        - `errors` CaiErrorCodeResponse[]
          - `errorCode` 'CAI-101' | 'CAI-102' | 'CAI-103' | 'CAI-104' | 'CAI-105' | 'CAI-106' | 'CAI-107' | 'CAI-108' | 'CAI-109' | 'CAI-110', required
          - `message` string, required — Helpful description of the errorCode
          - `parameterName` string — Name of parameter if specified in the message
  - object
    - `jobId` string
    - `creationTime` string, date-time
    - `completionTime` string, date-time
    - `expirationTime` string, date-time
    - `status` 'Success' | 'Fail'
    - `response` union
      - SpeakerIdentificationObject
        - `utterances` DiarizeSegment[], required
          - `speakerId` string, required
          - `start` number, float, required
          - `end` number, float, required
          - `confidence` number, float
      - CaiErrorResponse
        - `errors` CaiErrorCodeResponse[]
          - `errorCode` 'CAI-101' | 'CAI-102' | 'CAI-103' | 'CAI-104' | 'CAI-105' | 'CAI-106' | 'CAI-107' | 'CAI-108' | 'CAI-109' | 'CAI-110', required
          - `message` string, required — Helpful description of the errorCode
          - `parameterName` string — Name of parameter if specified in the message
  - object
    - `jobId` string
    - `creationTime` string, date-time
    - `completionTime` string, date-time
    - `expirationTime` string, date-time
    - `status` 'Success' | 'Fail'
    - `response` union
      - TranscribedObject
        - `speakerCount` integer — The number of speakers detected. Field is set only when enableSpeakerDiarization is true.
        - `utterances` UtteranceObject[] — Speaker wise utterances. Field is set only when enableSpeakerDiarization is true.
          - `start` number, float, required
          - `end` number, float, required
          - `text` string, required
          - `confidence` number, float
          - `speakerId` string
          - `wordTimings` WordTimingsUnit[]
            - `start` number, float
            - `end` number, float
            - `word` string
        - `words` WordSegment[], required
          - `speakerId` string
          - `start` number, float, required
          - `end` number, float, required
          - `confidence` number, float
          - `word` string, required
        - `confidence` number, float — Overall transcription confidence.
        - `transcript` string, required — The entire transcript with/without punctuations according to the input.
      - CaiErrorResponse
        - `errors` CaiErrorCodeResponse[]
          - `errorCode` 'CAI-101' | 'CAI-102' | 'CAI-103' | 'CAI-104' | 'CAI-105' | 'CAI-106' | 'CAI-107' | 'CAI-108' | 'CAI-109' | 'CAI-110', required
          - `message` string, required — Helpful description of the errorCode
          - `parameterName` string — Name of parameter if specified in the message
  - object
    - `jobId` string
    - `creationTime` string, date-time
    - `completionTime` string, date-time
    - `expirationTime` string, date-time
    - `status` 'Success' | 'Fail'
    - `response` union
      - EmotionSegment[]
        - `start` number, float, required
        - `end` number, float, required
        - `emotion` 'Anger' | 'Excitement' | 'Frustration' | 'Joy' | 'Sadness' | 'Neutral', required
        - `confidence` number, float
      - CaiErrorResponse
        - `errors` CaiErrorCodeResponse[]
          - `errorCode` 'CAI-101' | 'CAI-102' | 'CAI-103' | 'CAI-104' | 'CAI-105' | 'CAI-106' | 'CAI-107' | 'CAI-108' | 'CAI-109' | 'CAI-110', required
          - `message` string, required — Helpful description of the errorCode
          - `parameterName` string — Name of parameter if specified in the message
  - object
    - `jobId` string
    - `creationTime` string, date-time
    - `completionTime` string, date-time
    - `expirationTime` string, date-time
    - `status` 'Success' | 'Fail'
    - `response` union
      - InteractionObject
        - `utteranceInsights` UtteranceInsightsObject[]
          - `start` number, float, required
          - `end` number, float, required
          - `text` string, required
          - `confidence` number, float
          - `speakerId` string
          - `wordTimings` WordTimingsUnit[]
            - `start` number, float
            - `end` number, float
            - `word` string
          - `insights` UtteranceInsightsUnit[]
            - `name` 'Emotion', required
            - `value` string, required
            - `confidence` number, float
        - `speakerInsights` SpeakerInsightsObject
          - `speakerCount` integer
          - `insights` SpeakerInsightsUnit[]
            - `name` 'Energy' | 'Pace' | 'TalkToListenRatio' | 'QuestionsAsked', required
            - `values` SpeakerInsightsValuesItems[], required
              - …
        - `conversationalInsights` ConversationalInsightsUnit[]
          - `name` 'ExtractiveSummary' | 'AbstractiveSummaryLong' | 'AbstractiveSummaryShort' | 'KeyPhrases' | 'QuestionsAsked' | 'OverallSentiment' | 'Topics', required
          - `values` ConversationalInsightsUnitValues[], required
            - `confidence` number, float
            - `value` string, required
            - `start` number, float, required
            - `end` number, float, required
            - `groupId` string — Paragraph index of the long summary.
            - `speakerId` string
            - `assignee` string
            - `category` string
            - `text` string
            - `question` string
            - `answer` string
      - CaiErrorResponse
        - `errors` CaiErrorCodeResponse[]
          - `errorCode` 'CAI-101' | 'CAI-102' | 'CAI-103' | 'CAI-104' | 'CAI-105' | 'CAI-106' | 'CAI-107' | 'CAI-108' | 'CAI-109' | 'CAI-110', required
          - `message` string, required — Helpful description of the errorCode
          - `parameterName` string — Name of parameter if specified in the message

## Other responses

- `400` — Bad Request
- `404` — The {jobId} doesn't exist

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)