---
title: "Get Grok History"
method: POST
path: "/v3/twitter/grok/history"
tags: ["Grok Endpoints"]
---

# Get Grok History

`POST /v3/twitter/grok/history`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/v3/twitter/grok/history`
- Auth: HTTP bearer

Get Grok conversation history list.

## Request body

- GrokHistoryQuery: Parameters for getting Grok conversation history list
  - `count` integer, nullable: Number of conversations to return.
  - `cookie` string, required: The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).
  - `proxy` string, nullable: Optional HTTP proxy. Example: http://username:password@ip:port

## Response `200`

A list of Grok conversations.

- GrokHistoryResponse: Response for Grok conversation history list
  - `code` integer, required: Response code
  - `msg` string, required: Response message
  - `data` GrokHistoryItem[], required: Grok conversation list
    - `conversation_id` string, required: Grok conversation id
    - `id` string, nullable: Grok conversation id (alternate)
    - `title` string, required: Conversation title
    - `created_at_ms` integer, nullable: Created at timestamp in ms
    - `is_pinned` boolean: Whether the conversation is pinned

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twexapi/apis/twexapi-rest-api.md) · [All operations](https://skmtc.dev/twexapi/apis/twexapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twexapi/apis/twexapi-rest-api/revisions/59a99ac0d8f7?raw)
