GET
/
async
/
chat
/
completions
/
{request_id}
Get Async Chat Completion Response
curl --request GET \
  --url https://api.perplexity.ai/async/chat/completions/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "model": "<string>",
  "created_at": 123,
  "started_at": 123,
  "completed_at": 123,
  "response": {
    "id": "<string>",
    "model": "<string>",
    "created": 123,
    "usage": {
      "prompt_tokens": 123,
      "completion_tokens": 123,
      "total_tokens": 123,
      "search_context_size": "<string>",
      "citation_tokens": 123,
      "num_search_queries": 123,
      "reasoning_tokens": 123
    },
    "object": "chat.completion",
    "choices": [
      {
        "index": 123,
        "finish_reason": "stop",
        "message": {
          "content": "<string>",
          "role": "system"
        }
      }
    ],
    "search_results": [
      {
        "title": "<string>",
        "url": "<string>",
        "date": "2023-12-25"
      }
    ],
    "videos": [
      {
        "url": "<string>",
        "thumbnail_url": "<string>",
        "thumbnail_width": 123,
        "thumbnail_height": 123,
        "duration": 123
      }
    ]
  },
  "failed_at": 123,
  "error_message": "<string>",
  "status": "CREATED"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

request_id
string
required

The ID of the asynchronous chat completion request.

Response

Successfully retrieved async chat completion response.

id
string
required

Unique identifier for the asynchronous job.

model
string
required

The model used for the request.

created_at
integer
required

Unix timestamp of when the job was created.

status
enum<string>
required

The status of an asynchronous processing job.

Available options:
CREATED,
IN_PROGRESS,
COMPLETED,
FAILED
started_at
integer | null

Unix timestamp of when processing started.

completed_at
integer | null

Unix timestamp of when processing completed.

response
object

The actual chat completion response, available when status is COMPLETED.

failed_at
integer | null

Unix timestamp of when processing failed.

error_message
string | null

Error message if the job failed.