> This page is for version 2025-11-27 (default).
> For other versions, use one of these documentation indexes:
> - 2025-11-27 (default): https://docs.caesar.xyz/2025-11-27/llms.txt
> - 2025-08-08: https://docs.caesar.xyz/2025-08-08/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.caesar.xyz/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.caesar.xyz/_mcp/server.

# Get Research Objects

GET https://api.caesar.xyz/research

Returns a paginated list of research objects.

Reference: https://docs.caesar.xyz/api-reference/api-reference/research/get-research-objects

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Query parameters

- `page` (integer, optional, default: 1) — 1-based page index.
- `limit` (integer, optional, default: 10) — Page size (items per page).

## Response

### 200

A paginated list of research objects.

- `data` (list of ResearchResponseObject, required) — List of research objects.
- `pagination` (PageMeta, required)

## Errors

### 401 Unauthorized Error

Unauthorized — invalid or missing API key.

- `error` (string, required) — Human-readable error description.

### 500 Internal Server Error

Internal server error.

- `error` (string, required) — Human-readable error description.

## Types

### ResearchResponseObject

- `id` (string, required) — Research job identifier.
- `created_at` (datetime, required) — ISO 8601 timestamp when the job was created.
- `status` (enum, required) — Current status of the research job: - `queued`: Job accepted, waiting to start - `searching`: Gathering sources from the web - `researching`: Processing and analyzing sources - `analyzing`: Deep analysis of gathered information - `summarizing`: Generating final synthesis - `completed`: Research finished successfully - `failed`: Research encountered an error
  - Allowed values: `queued`, `searching`, `summarizing`, `analyzing`, `completed`, `failed`, `researching`
- `query` (string, required) — Original query.
- `reasoning_loops_consumed` (integer, required) — The actual number of reasoning loops executed during the research. May be less than the requested maximum if early exit was allowed.
- `running_time` (integer, required) — Total execution time in seconds for the research job.
- `results` (list of ResearchResultItem, required) — Sources used in the research, ordered by citation index.
- `content` (string, optional, nullable) — Final synthesized response with inline citations. Citations appear as bracketed numbers (e.g., [1], [2]) that correspond to the `citation_index` in the results array. Null until research completes.
- `transformed_content` (string, optional, nullable) — Post-processed content (e.g., formatted/converted).

### PageMeta

- `limit` (integer, required) — Page size (items per page).
- `page` (integer, required) — Current page number (1-based).
- `has_next` (boolean, required) — Whether another page is available.
- `total` (integer, optional) — Total number of items (may be omitted).

### ResearchResultItem

- `id` (string, required) — Result object identifier.
- `title` (string, required) — Result title.
- `url` (string, required) — Canonical URL of the result.
- `citation_index` (integer, optional) — Index used for inline citations in the response content.

## Examples

**Response**

```json
{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created_at": "2024-01-15T09:30:00Z",
      "status": "queued",
      "query": "Impact of renewable energy adoption on global carbon emissions",
      "reasoning_loops_consumed": 2,
      "running_time": 45,
      "results": [
        {
          "id": "1e4d5f7a-8b3c-4d2a-9f7e-123456789abc",
          "title": "Renewable Energy and Carbon Emissions: A Comprehensive Review",
          "url": "https://www.sciencedirect.com/science/article/pii/S1364032120301234",
          "citation_index": 1
        }
      ],
      "content": null,
      "transformed_content": null
    }
  ],
  "pagination": {
    "limit": 10,
    "page": 1,
    "has_next": true,
    "total": 25
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.caesar.xyz/research"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.caesar.xyz/research';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.caesar.xyz/research"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.caesar.xyz/research")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.caesar.xyz/research")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.caesar.xyz/research', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.caesar.xyz/research");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.caesar.xyz/research")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```