---
title: "Get analysis status and results"
method: GET
path: "/analyze-conversations/jobs/{jobId}"
---

# Get analysis status and results

`GET /analyze-conversations/jobs/{jobId}`

Get the status of an analysis job. A job can consist of one or more tasks. After all tasks succeed, the job transitions to the succeeded state and results are available for each task.

## Path parameters

- `jobId` string, uuid, required

## Query parameters

- `api-version` string, required
- `showStats` boolean

## Response `200`

The request has succeeded.

- AnalyzeConversationJobState — Contains the status of the submitted job for analyzing a conversation, along with related statistics.
  - `displayName` string — display name
  - `createdDateTime` string, date-time, required — Date and time job created
  - `expirationDateTime` string, date-time — Date and time job expires
  - `jobId` string, uuid, required — Universally Unique Identifier
  - `lastUpdatedDateTime` string, date-time, required — last updated date and time
  - `status` 'notStarted' | 'running' | 'succeeded' | 'partiallyCompleted' | 'failed' | 'cancelled' | 'cancelling', required — The status of the task at the mentioned last update time.
  - `errors` Error[] — errors
    - `code` 'InvalidRequest' | 'InvalidArgument' | 'Unauthorized' | 'Forbidden' | 'NotFound' | 'ProjectNotFound' | 'OperationNotFound' | 'AzureCognitiveSearchNotFound' | 'AzureCognitiveSearchIndexNotFound' | 'TooManyRequests' | 'AzureCognitiveSearchThrottling' | 'AzureCognitiveSearchIndexLimitReached' | 'InternalServerError' | 'ServiceUnavailable' | 'Timeout' | 'QuotaExceeded' | 'Conflict' | 'Warning', required — Human-readable error code.
    - `message` string, required — A human-readable representation of the error.
    - `target` string — The target of the error.
    - `details` Error[] — An array of details about specific errors that led to this reported error.
    - `innererror` InnerErrorModel — An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
      - `code` 'InvalidRequest' | 'InvalidParameterValue' | 'KnowledgeBaseNotFound' | 'AzureCognitiveSearchNotFound' | 'AzureCognitiveSearchThrottling' | 'ExtractionFailure' | 'InvalidRequestBodyFormat' | 'EmptyRequest' | 'MissingInputDocuments' | 'InvalidDocument' | 'ModelVersionIncorrect' | 'InvalidDocumentBatch' | 'UnsupportedLanguageCode' | 'InvalidCountryHint', required — Human-readable error code.
      - `message` string, required — Error message.
      - `details` object — Error details.
      - `target` string — Error target.
      - `innererror` InnerErrorModel — recursive
  - `nextLink` string — next link
  - `tasks` Tasks, required — Contains the state for the tasks that are being executed as part of the submitted job for analyzing a conversation.
    - `completed` integer, required — Count of tasks that finished successfully.
    - `failed` integer, required — Count of tasks that failed.
    - `inProgress` integer, required — Count of tasks that are currently in progress.
    - `total` integer, required — Total count of tasks submitted as part of the job.
    - `items` AnalyzeConversationJobResult[] — List of results from tasks (if available).
      - `lastUpdateDateTime` string, date-time, required — The last updated time in UTC for the task.
      - `status` 'notStarted' | 'running' | 'succeeded' | 'partiallyCompleted' | 'failed' | 'cancelled' | 'cancelling', required — The status of the task at the mentioned last update time.
      - `taskName` string — task name
      - `kind` 'conversationalSummarizationResults' | 'conversationalPIIResults' | 'customConversationalSummarizationResults', required — Enumeration of results for supported conversation analysis Results.
  - `statistics` ConversationRequestStatistics — if showStats=true was specified in the request, this field contains information about the request payload.
    - `documentsCount` integer, required — Number of documents submitted in the request.
    - `validDocumentsCount` integer, required — Number of valid documents. This excludes empty, over-size limit or non-supported languages documents.
    - `erroneousDocumentsCount` integer, required — Number of invalid documents. This includes empty, over-size limit or non-supported languages documents.
    - `transactionsCount` integer, required — Number of transactions for the request.
    - `conversationsCount` integer, required — Number of conversations submitted in the request.
    - `validConversationsCount` integer, required — Number of conversation documents. This excludes documents that are empty, over the size limit, or in unsupported languages.
    - `erroneousConversationsCount` integer, required — Number of invalid documents. This includes documents that are empty, over the size limit, or in unsupported languages.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-languageanalyzeconversations.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-languageanalyzeconversations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-languageanalyzeconversations/revisions/79233defacd8/schema)