GET
GET /chat/completions/{completion_id} — OpenAI API
OpenAI API key (required); https://api.openai.com/v1
OpenAI APIGet chat completion
- Base URL
- https://api.openai.com/v1
- Auth
- Authorization: Bearer <OPENAI_API_KEY>
- Last verified
- 2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 163 tokens · Vary: Accept
→ 163 tokens · Vary: Accept
Critical gotchas
The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
Audio transcription uploads use multipart form data rather than a JSON request body.
cURL
curl -X GET 'https://api.openai.com/v1/chat/completions/completion-id' \ -H "Authorization: Bearer $OPENAI_API_KEY"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| completion_id | path | string | Yes | The ID of the chat completion to retrieve. |
Response 200 OK
{
"id": "string",
"choices": [
{
"finish_reason": "stop",
"index": 0,
"message": {
"content": "string",
"refusal": "string",
"tool_calls": [
{
"id": "[recursive or deeply nested schema]",
"type": "[recursive or deeply nested schema]",
"function": "[recursive or deeply nested schema]"
}
],
"annotations": [
{
"type": "[recursive or deeply nested schema]",
"url_citation": "[recursive or deeply nested schema]"
}
],
"role": "assistant",
"function_call": {
"arguments": "string",
"name": "string"
},
"audio": {
"id": "string",
"expires_at": 0,
"data": "string",
"transcript": "string"
}
},
"logprobs": {
"content": [
{
"token": "[recursive or deeply nested schema]",
"logprob": "[recursive or deeply nested schema]",
"bytes": "[recursive or deeply nested schema]",
"top_logprobs": "[recursive or deeply nested schema]"
}
],
"refusal": [
{
"token": "[recursive or deeply nested schema]",
"logprob": "[recursive or deeply nested schema]",
"bytes": "[recursive or deeply nested schema]",
"top_logprobs": "[recursive or deeply nested schema]"
}
]
}
}
],
"created": 0,
"model": "string",
"metadata": {},
"service_tier": "auto",
"system_fingerprint": "string",
"object": "chat.completion",
"usage": {
"completion_tokens": 0,
"prompt_tokens": 0,
"total_tokens": 0,
"completion_tokens_details": {
"accepted_prediction_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 0,
"text_tokens": 0,
"rejected_prediction_tokens": 0
},
"prompt_tokens_details": {
"audio_tokens": 0,
"cached_tokens": 0,
"text_tokens": 0,
"image_tokens": 0,
"cache_write_tokens": 0
}
},
"moderation": {
"input": {
"type": "moderation_results",
"model": "string",
"results": [
{
"type": "moderation_result",
"model": "string",
"flagged": true,
"categories": {},
"category_scores": {},
"category_applied_input_types": {}
}
]
},
"output": {
"type": "moderation_results",
"model": "string",
"results": [
{
"type": "moderation_result",
"model": "string",
"flagged": true,
"categories": {},
"category_scores": {},
"category_applied_input_types": {}
}
]
}
}
} Get a free OpenAI API key → sponsored Affiliate link - we may earn a commission, at no extra cost to you.