List Chat Completions

List stored Chat Completions. Only Chat Completions that have been stored with the store parameter set to true will be returned.

GET /chat/completions

List Chat Completions

cURL

curl --request GET \
  --url https://api.openai.com/v1/chat/completions \
  --header 'Authorization: Bearer <token>'

200

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "choices": [
        {
          "finish_reason": "stop",
          "index": 123,
          "message": {
            "content": "<string>",
            "refusal": "<string>",
            "role": "assistant",
            "tool_calls": [
              {
                "id": "<string>",
                "type": "function",
                "function": {
                  "name": "<string>",
                  "arguments": "<string>"
                }
              }
            ],
            "annotations": [
              {
                "type": "url_citation",
                "url_citation": {
                  "end_index": 123,
                  "start_index": 123,
                  "url": "<string>",
                  "title": "<string>"
                }
              }
            ],
            "function_call": {
              "arguments": "<string>",
              "name": "<string>"
            },
            "audio": {
              "id": "<string>",
              "expires_at": 123,
              "data": "<string>",
              "transcript": "<string>"
            }
          },
          "logprobs": {
            "content": [
              {
                "token": "<string>",
                "logprob": 123,
                "bytes": [
                  123
                ],
                "top_logprobs": [
                  {
                    "token": "<string>",
                    "logprob": 123,
                    "bytes": [
                      123
                    ]
                  }
                ]
              }
            ],
            "refusal": [
              {
                "token": "<string>",
                "logprob": 123,
                "bytes": [
                  123
                ],
                "top_logprobs": [
                  {
                    "token": "<string>",
                    "logprob": 123,
                    "bytes": [
                      123
                    ]
                  }
                ]
              }
            ]
          }
        }
      ],
      "created": 123,
      "model": "<string>",
      "object": "chat.completion",
      "service_tier": "auto",
      "system_fingerprint": "<string>",
      "usage": {
        "completion_tokens": 0,
        "prompt_tokens": 0,
        "total_tokens": 0,
        "completion_tokens_details": {
          "accepted_prediction_tokens": 0,
          "audio_tokens": 0,
          "reasoning_tokens": 0,
          "rejected_prediction_tokens": 0
        },
        "prompt_tokens_details": {
          "audio_tokens": 0,
          "cached_tokens": 0
        }
      }
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}

Authorizations

Authorization · string · header · required

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

Query Parameters

model · string

The model used to generate the Chat Completions.

metadata · object

A list of metadata keys to filter the Chat Completions by. Example:

metadata[key1]=value1&metadata[key2]=value2

Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard.

Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.

Show child attributes

after · string

Identifier for the last chat completion from the previous pagination request.

limit · integer · default: 20

Number of Chat Completions to retrieve.

order · enum<string> · default: asc

Sort order for Chat Completions by timestamp. Use asc for ascending order or desc for descending order. Defaults to asc.

Available options: asc, desc

Response

200 - application/json

A list of Chat Completions

An object representing a list of Chat Completions.

object · enum<string> · default: list · required

The type of this object. It is always set to "list".

Available options: list

data · object[] · required

An array of chat completion objects.

Show child attributes

first_id · string · required

The identifier of the first chat completion in the data array.

last_id · string · required

The identifier of the last chat completion in the data array.

has_more · boolean · required

Indicates whether there are more Chat Completions available.