> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Start with /introduction/getting-started. Use the Inference API's Direct Query endpoint (POST /api/inference/query) with the newton-c-2.6 or newton-fusion-1.0 model (text, image, and video reasoning) or the omega-embedding encoder (time-series embeddings). ATAI_API_ENDPOINT is the base URL https://platform.u1.archetypeai.app with no version path; every endpoint path begins with /api. Pages whose descriptions are marked (Archived) document the legacy Lens runtime — do not use them for new projects.

# Get Session Results

> Page through the output files a batch session produced

Requires [version 2.0.1](https://docs.archetypeai.app/release-notes/2.0.x.md#v2-0-1) or later of the Archetype platform.

## Overview

This endpoint returns a page of the output files a `batch` session's job produced, newest first.
Each entry points at a stored file.

## Request

**session\_id** `string` *required*

Session `ses_` id.

**limit** `integer` (default: 100)

Page size. Minimum `1`, maximum `1000`.

**after** `string`

Forward cursor: return results older than this page. Pass the previous page's `next_cursor`. The
cursor is opaque: it is not a result id, so never compute on it. Mutually exclusive with
`before`.

**before** `string`

Backward cursor: return results newer than this page. Opaque, as `after` is. Mutually exclusive
with `after`.

## Response

**data** `array` *required*

The page, newest first. Each entry is one output file the session produced.

**has\_more** `boolean` *required*

True when more results exist beyond this page in the direction of travel.

**next\_cursor** `string`

Cursor for the next page in the same direction. Pass it as `after` when paging forward, or as
`before` when you supplied `before`. `null` when `has_more` is false.

**prev\_cursor** `string`

Cursor to step back the way this page was reached. Pass it as `before` after a forward page, or
as `after` after a backward one. `null` when the request carried no cursor.

### Result entry object

**data** `object` *required*

The stored file and how to fetch it.

**created\_at** `string` *required*

When the result was recorded (date-time).

### File ref object (`data`)

**ref** `string` *required*

Fetchable reference to the bytes: a presigned URL, or a data-service ref that has to be downloaded through the authenticated proxy.

**filename** `string` *required*

Name of the stored file.

**file\_extension** `string`

File extension; `null` when unknown.

**file\_type** `string`

File type; `null` when unknown.

**num\_bytes** `integer`

Size of the file in bytes; `null` when unknown.

**file\_attributes** `object`

Executor-recorded attributes. Carries `job_output.status`, which marks a result written by a run that only partially succeeded.

```bash cURL theme={"system"}
curl "$ATAI_API_ENDPOINT/agents/sessions/ses_01jcf4p9r6wy3nv8s5m7jcae0b/results?limit=50" \
  -H "Authorization: Bearer $ATAI_API_KEY"
```

```python Python theme={"system"}
import os
import requests

base_url = os.environ["ATAI_API_ENDPOINT"]
api_key = os.environ["ATAI_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}"}
results_url = f"{base_url}/agents/sessions/ses_01jcf4p9r6wy3nv8s5m7jcae0b/results"

cursor = None
while True:
    params = {"limit": 100}
    if cursor:
        params["after"] = cursor

    response = requests.get(results_url, headers=headers, params=params)
    if response.status_code != 200:
        print(f"Error: {response.json()['errors']}")
        break

    page = response.json()
    for result in page["data"]:
        file_ref = result["data"]
        print(f"{file_ref['filename']} -> {file_ref['ref']}")

    if not page["has_more"]:
        break
    # The cursor is opaque: pass it back verbatim.
    cursor = page["next_cursor"]
```

```javascript JavaScript theme={"system"}
const response = await fetch(
  `${process.env.ATAI_API_ENDPOINT}/agents/sessions/ses_01jcf4p9r6wy3nv8s5m7jcae0b/results?limit=50`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

const body = await response.json();

if (response.ok) {
  body.data.forEach((result) => console.log(result.data.filename, result.data.ref));
} else {
  console.error('Error:', body.errors);
}
```

```json 200 - Page of results theme={"system"}
{
  "data": [
    {
      "data": {
        "ref": "https://<presigned-url>",
        "filename": "predictions.ndjson",
        "file_extension": "ndjson",
        "file_type": null,
        "num_bytes": 48213,
        "file_attributes": {
          "job_output.status": "<status>"
        }
      },
      "created_at": "2026-10-29T16:12:38Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "prev_cursor": null
}
```

## Important Notes

> [!NOTE]
>
> * Passing both `after` and `before` returns `400`, as does a malformed cursor.
> * A `409` means the session is a `serving` session, which writes no output files. Its answers are returned by [Query Session](https://docs.archetypeai.app/api-reference/agents/sessions/query-session.md).
> * A `404` means the session does not exist, belongs to another organization, or is in a project you cannot see.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.