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

# Working with Downloads

> The asynchronous request lifecycle, filter and sort grammar, and the full catalog of data contexts available in the Downloads API.

The Downloads API exports any data domain in your Oleria workspace as a CSV. Every request is asynchronous: you create a request, poll until it completes, then fetch the resulting CSV from a presigned URL. This page covers the lifecycle, the filter and sort grammar, and the full catalog of data contexts.

## The asynchronous lifecycle

Every download is asynchronous — create a request, poll it, then fetch the CSV.

<Steps>
  <Step title="Create a download request">
    `POST /v1/downloads` with a `context` (the data domain) and an optional `params` object for filters and sort order. You get back a `DownloadRequest` with a UUID `id` and `status: "accepted"`. See the request schema and ready-to-run examples on [Create a download request](/api-reference/downloads/create-a-download-request).
  </Step>

  <Step title="Poll for completion">
    `GET /v1/downloads/{id}` returns the request state. `status` moves from `accepted` to either `completed` (with a presigned `url`) or `failed` (with a populated `error`). Use exponential back-off — large exports can take seconds to minutes depending on the context and filter set. See [Get a download request](/api-reference/downloads/get-a-download-request) for the response schema.
  </Step>

  <Step title="Fetch the CSV">
    `GET` the presigned `url` directly. It expires after 5 minutes, so download or stream it as soon as the request completes. No Oleria authentication is required on the presigned URL itself.
  </Step>
</Steps>

## Filtering and sorting

`params.filterBy` applies AND-combined filters before export. Each filter declares the column's `dataType`, the `field`, a `filterType` operator, and `values` — and the valid operators depend on the `dataType`. The [`filterBy` schema on Create a download request](/api-reference/downloads/create-a-download-request) lists the operators allowed for each type (and the value rules for `between`/`in`/`last`), so this page doesn't repeat — and can't drift from — that matrix.

`params.sortBy` orders results — each entry takes a `field` and a `sortType` of `asc` or `desc`.

## What you can export

Each row is a data domain you can export. Open [Create a download request](/api-reference/downloads/create-a-download-request)
to pick the matching `context`, see the request schema, and run it from the playground.

| Entity                                                                         | What it returns                                                            |
| :----------------------------------------------------------------------------- | :------------------------------------------------------------------------- |
| [Access Inventory](/api-reference/downloads/create-a-download-request)         | Snapshots of who has access to what, by identity / account / group / role. |
| [Identity & Employees](/api-reference/downloads/create-a-download-request)     | Canonical identity and HR records, plus per-employee access posture.       |
| [Utilization](/api-reference/downloads/create-a-download-request)              | Activity-weighted views of how access is actually used.                    |
| [Risk & Activity](/api-reference/downloads/create-a-download-request)          | Detected risks, monitoring detail, and the raw activity log.               |
| [Identity Assessments](/api-reference/downloads/create-a-download-request)     | Periodic assessment outputs across entitlements and resources.             |
| [Identity Lifecycle (ILM)](/api-reference/downloads/create-a-download-request) | Joiner / mover / leaver events and the workflows they triggered.           |
| [External Access](/api-reference/downloads/create-a-download-request)          | Third-party users, anonymous shares, and externally shared assets.         |
| [Access Requests](/api-reference/downloads/create-a-download-request)          | Submitted access requests and their status.                                |
| [Reference](/api-reference/downloads/create-a-download-request)                | Resource and application catalog data.                                     |

<Card title="Create a download request" icon="download" href="/api-reference/downloads/create-a-download-request">
  Pick the `context` for the entity you want, then run it from the interactive playground.
</Card>

## Contact us

For questions about the Downloads API, contact us at [support@oleria.com](mailto:support@oleria.com).