apicheats.dev openai/llms.txt Raw .md
GET

GET /chat/completions/{completion_id} — OpenAI API

OpenAI API key (required); https://api.openai.com/v1

OpenAI API

Get 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

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.