curl -X GET 'https://api.openai.com/v1/chatkit/threads/cthr_123/items?limit=10&order=asc&after=example-after&before=example-before' \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# GET /chatkit/threads/{thread_id}/items (OpenAI API)
Base URL: https://api.openai.com/v1
Auth: Authorization; OpenAI API key; required.
Last verified: 2026-10-20

> List ChatKit thread items

## 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/chatkit/threads/cthr_123/items?limit=10&order=asc&after=example-after&before=example-before' \
  -H "Authorization: Bearer $OPENAI_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| thread_id | path | string | Yes | Identifier of the ChatKit thread whose items are requested. |
| limit | query | integer | No | Maximum number of thread items to return. Defaults to 20. |
| order | query | string | No | Sort order for results by creation time. Defaults to `desc`. |
| after | query | string | No | List items created after this thread item ID. Defaults to null for the first... |
| before | query | string | No | List items created before this thread item ID. Defaults to null for the newes... |

## Response example
{"object":"list","data":[{}]}

---
Need an API key? Get one at https://platform.openai.com/api-keys

GET

GET /chatkit/threads/{thread_id}/items — OpenAI API

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

OpenAI API

List ChatKit thread items

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
→ 280 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/chatkit/threads/cthr_123/items?limit=10&order=asc&after=example-after&before=example-before' \  -H "Authorization: Bearer $OPENAI_API_KEY"

Parameters

Name	In	Type	Required	Description
thread_id	path	string	Yes	Identifier of the ChatKit thread whose items are requested.
limit	query	integer	No	Maximum number of thread items to return. Defaults to 20.
order	query	string	No	Sort order for results by creation time. Defaults to `desc`.
after	query	string	No	List items created after this thread item ID. Defaults to null for the first page.
before	query	string	No	List items created before this thread item ID. Defaults to null for the newest results.

Response 200 OK

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "object": "chatkit.thread_item",
      "created_at": 0,
      "thread_id": "string",
      "type": "chatkit.user_message",
      "content": [
        {
          "type": "input_text",
          "text": "string"
        }
      ],
      "attachments": [
        {
          "type": "image",
          "id": "string",
          "name": "string",
          "mime_type": "string",
          "preview_url": "https://example.com"
        }
      ],
      "inference_options": {
        "tool_choice": {
          "id": "string"
        },
        "model": "string"
      }
    }
  ],
  "first_id": "string",
  "last_id": "string",
  "has_more": true
}

Get a free OpenAI API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.