---
title: "List Partitions"
method: GET
path: "/partitions"
tags: ["partitions"]
---

# List Partitions

`GET /partitions`

List all partitions sorted by name in ascending order. Results are paginated with a max limit of 100. When more partitions are available, a `cursor` will be provided. Use the `cursor` parameter to retrieve the subsequent page.

## Query parameters

- `cursor` string, nullable — An opaque cursor for pagination
- `page_size` integer — The number of items per page (must be greater than 0 and less than or equal to 100)

## Response `200`

Successful Response

- PartitionList
  - `pagination` Pagination, required
    - `next_cursor` string, nullable
    - `total_count` integer, required
  - `partitions` Partition[], required
    - `name` string, required
    - `is_default` boolean, required
    - `limit_exceeded_at` string, date-time, nullable — Timestamp when the partition exceeded its limits, if applicable.
    - `description` string, nullable, required
    - `context_aware` boolean, required
    - `metadata_schema` object, nullable, required
    - `limits` PartitionLimits, required
      - `pages_processed_limit_monthly` integer, nullable — Monthly limit, in pages, for processed documents in the partition.
      - `pages_hosted_limit_monthly` integer, nullable — Monthly limit of hosted pages added in the current month in the partition.
      - `pages_processed_limit_max` integer, nullable — Maximum limit, in pages, for processed documents in the partition.
      - `pages_hosted_limit_max` integer, nullable — Maximum limit, in pages, for hosted documents in the partition.
      - `video_processed_limit_monthly` integer, nullable — Monthly limit, in minutes, for video processing in the partition.
      - `video_processed_limit_max` integer, nullable — Maximum limit, in minutes, for video processing in the partition.
      - `audio_processed_limit_monthly` integer, nullable — Monthly limit, in minutes, for audio processing in the partition.
      - `audio_processed_limit_max` integer, nullable — Maximum limit, in minutes, for audio processing in the partition.
      - `media_streamed_limit_monthly` integer, nullable — Monthly limit, in MBs, for media streamed from the partition.
      - `media_streamed_limit_max` integer, nullable — Maximum limit, in MBs, for media streamed from the partition.
      - `media_hosted_limit_monthly` integer, nullable — Monthly limit, in MBs, for media hosted in the partition.
      - `media_hosted_limit_max` integer, nullable — Maximum limit, in MBs, for media hosted in the partition.

## Other responses

- `401` — Unauthorized
- `402` — Payment Required
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ragie/apis/ragie-api.md) · [All operations](https://skmtc.dev/ragie/apis/ragie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ragie/ragie-api/revisions/ffdf960539ca/schema)