Skip to main content
GET
/
research
/
v1
/
{researchId}
Get a research request by id
curl --request GET \
  --url https://api.exa.ai/research/v1/research/v1/{researchId}
{
  "researchId": "01jszdfs0052sg4jc552sg4jc5",
  "model": "exa-research",
  "instructions": "What species of ant are similar to honeypot ants?",
  "status": "running"
}

Get your Exa API key

Path Parameters

​
researchId
string
required

The unique identifier of the research request to retrieve

Query Parameters

​
stream
string

Set to "true" to receive real-time updates via Server-Sent Events (SSE)

​
events
string

Set to "true" to include the detailed event log of all operations performed

Response

200 - application/json
  • Pending
  • Running
  • Completed
  • Canceled
  • Failed
​
researchId
string
required

Unique identifier for tracking and retrieving this research request

​
createdAt
number
required

When the research was created (Unix timestamp in milliseconds)

​
instructions
string
required

The original research instructions provided

​
status
enum<string>
required
Available options:
pending
​
model
enum<string>
default:exa-research

The model used for this research request

Available options:
exa-research,
exa-research-pro
​
outputSchema
object

The JSON Schema used to validate the output, if provided

⌘I