## List quota configurations

**get** `/api/v1/beta/quota-management`

Retrieve a paginated list of quota configurations with optional filtering. When expand=true, returns resolved quotas (effective values after fallback chain) and pagination parameters are ignored.

### Query Parameters

- `source_id: string`

- `source_type: "GLOBAL" or "organization" or "plan_tier" or "project"`

  - `"GLOBAL"`

  - `"organization"`

  - `"plan_tier"`

  - `"project"`

- `configuration_type: optional "allow_pay_as_you_go" or "limit_agent_coder_daily_usage_usd" or "limit_agent_deployments" or 61 more`

  - `"allow_pay_as_you_go"`

  - `"limit_agent_coder_daily_usage_usd"`

  - `"limit_agent_deployments"`

  - `"limit_batch_files"`

  - `"limit_classify_input_tokens"`

  - `"limit_daily_usage_credits"`

  - `"limit_directories"`

  - `"limit_directory_files_per_directory"`

  - `"limit_directory_ingest_download_size_bytes"`

  - `"limit_directory_ingest_files"`

  - `"limit_directory_sync_plan_actions"`

  - `"limit_embedding_character"`

  - `"limit_files_per_index"`

  - `"limit_max_monthly_invoice_total_usd_cents"`

  - `"limit_monthly_usage_credits"`

  - `"limit_projects"`

  - `"limit_split_categories"`

  - `"limit_total_file_count"`

  - `"limit_total_file_storage_bytes"`

  - `"limit_users"`

  - `"rate_limit_batch_api_creation"`

  - `"rate_limit_chat_api_message"`

  - `"rate_limit_classify_api_creation"`

  - `"rate_limit_classify_api_list"`

  - `"rate_limit_classify_api_query"`

  - `"rate_limit_concurrent_jobs_in_execution_default"`

  - `"rate_limit_concurrent_jobs_in_execution_doc_ingest"`

  - `"rate_limit_concurrent_jobs_in_execution_metadata_update"`

  - `"rate_limit_default_api_read"`

  - `"rate_limit_default_api_write"`

  - `"rate_limit_directory_file_api_read"`

  - `"rate_limit_directory_file_api_write"`

  - `"rate_limit_directory_ingest_project_job_creation"`

  - `"rate_limit_extract_agent_creation"`

  - `"rate_limit_extract_api_creation"`

  - `"rate_limit_extract_api_list"`

  - `"rate_limit_extract_api_query"`

  - `"rate_limit_extract_concurrent_default"`

  - `"rate_limit_file_api_read"`

  - `"rate_limit_file_api_write"`

  - `"rate_limit_index_v1_pipeline_concurrent_jobs"`

  - `"rate_limit_parse_api_creation"`

  - `"rate_limit_parse_api_list"`

  - `"rate_limit_parse_api_query"`

  - `"rate_limit_parse_concurrent_default"`

  - `"rate_limit_parse_concurrent_pages_agentic"`

  - `"rate_limit_parse_concurrent_pages_agentic_plus"`

  - `"rate_limit_parse_concurrent_pages_cost_effective"`

  - `"rate_limit_parse_concurrent_premium"`

  - `"rate_limit_parse_token_bucket_agentic"`

  - `"rate_limit_parse_token_bucket_agentic_plus"`

  - `"rate_limit_parse_token_bucket_cost_effective"`

  - `"rate_limit_parse_token_bucket_unknown_tier"`

  - `"rate_limit_project_concurrent_jobs"`

  - `"rate_limit_project_concurrent_turbo_jobs"`

  - `"rate_limit_split_api_creation"`

  - `"rate_limit_split_api_query"`

  - `"rate_limit_spreadsheet_api_list"`

  - `"rate_limit_spreadsheet_api_query"`

  - `"rate_limit_spreadsheet_creation"`

  - `"rate_limit_usage_api_query"`

  - `"rate_limit_verify_api_creation"`

  - `"rate_limit_verify_api_list"`

  - `"rate_limit_verify_api_query"`

- `exclude_self_service: optional boolean`

- `expand: optional boolean`

- `page: optional number`

- `page_size: optional number`

### Cookie Parameters

- `session: optional string`

### Returns

- `items: array of QuotaConfiguration`

  - `configuration_metadata: map[unknown]`

    The configuration metadata

  - `configuration_type: "allow_pay_as_you_go" or "limit_agent_coder_daily_usage_usd" or "limit_agent_deployments" or 61 more`

    The quota configuration type

    - `"allow_pay_as_you_go"`

    - `"limit_agent_coder_daily_usage_usd"`

    - `"limit_agent_deployments"`

    - `"limit_batch_files"`

    - `"limit_classify_input_tokens"`

    - `"limit_daily_usage_credits"`

    - `"limit_directories"`

    - `"limit_directory_files_per_directory"`

    - `"limit_directory_ingest_download_size_bytes"`

    - `"limit_directory_ingest_files"`

    - `"limit_directory_sync_plan_actions"`

    - `"limit_embedding_character"`

    - `"limit_files_per_index"`

    - `"limit_max_monthly_invoice_total_usd_cents"`

    - `"limit_monthly_usage_credits"`

    - `"limit_projects"`

    - `"limit_split_categories"`

    - `"limit_total_file_count"`

    - `"limit_total_file_storage_bytes"`

    - `"limit_users"`

    - `"rate_limit_batch_api_creation"`

    - `"rate_limit_chat_api_message"`

    - `"rate_limit_classify_api_creation"`

    - `"rate_limit_classify_api_list"`

    - `"rate_limit_classify_api_query"`

    - `"rate_limit_concurrent_jobs_in_execution_default"`

    - `"rate_limit_concurrent_jobs_in_execution_doc_ingest"`

    - `"rate_limit_concurrent_jobs_in_execution_metadata_update"`

    - `"rate_limit_default_api_read"`

    - `"rate_limit_default_api_write"`

    - `"rate_limit_directory_file_api_read"`

    - `"rate_limit_directory_file_api_write"`

    - `"rate_limit_directory_ingest_project_job_creation"`

    - `"rate_limit_extract_agent_creation"`

    - `"rate_limit_extract_api_creation"`

    - `"rate_limit_extract_api_list"`

    - `"rate_limit_extract_api_query"`

    - `"rate_limit_extract_concurrent_default"`

    - `"rate_limit_file_api_read"`

    - `"rate_limit_file_api_write"`

    - `"rate_limit_index_v1_pipeline_concurrent_jobs"`

    - `"rate_limit_parse_api_creation"`

    - `"rate_limit_parse_api_list"`

    - `"rate_limit_parse_api_query"`

    - `"rate_limit_parse_concurrent_default"`

    - `"rate_limit_parse_concurrent_pages_agentic"`

    - `"rate_limit_parse_concurrent_pages_agentic_plus"`

    - `"rate_limit_parse_concurrent_pages_cost_effective"`

    - `"rate_limit_parse_concurrent_premium"`

    - `"rate_limit_parse_token_bucket_agentic"`

    - `"rate_limit_parse_token_bucket_agentic_plus"`

    - `"rate_limit_parse_token_bucket_cost_effective"`

    - `"rate_limit_parse_token_bucket_unknown_tier"`

    - `"rate_limit_project_concurrent_jobs"`

    - `"rate_limit_project_concurrent_turbo_jobs"`

    - `"rate_limit_split_api_creation"`

    - `"rate_limit_split_api_query"`

    - `"rate_limit_spreadsheet_api_list"`

    - `"rate_limit_spreadsheet_api_query"`

    - `"rate_limit_spreadsheet_creation"`

    - `"rate_limit_usage_api_query"`

    - `"rate_limit_verify_api_creation"`

    - `"rate_limit_verify_api_list"`

    - `"rate_limit_verify_api_query"`

  - `configuration_value: object { numerator, denominator, denominator_units }`

    The quota configuration value

    - `numerator: number`

      The rate numerator

    - `denominator: optional number`

      The rate limit denominator

    - `denominator_units: optional "day" or "hour" or "minute" or "second"`

      The default rate limit denominator units

      - `"day"`

      - `"hour"`

      - `"minute"`

      - `"second"`

  - `source_id: string`

    The source ID, e.g. the organization ID

  - `source_type: "GLOBAL" or "organization" or "plan_tier" or "project"`

    The source type, e.g. 'organization'

    - `"GLOBAL"`

    - `"organization"`

    - `"plan_tier"`

    - `"project"`

  - `status: "ACTIVE" or "INACTIVE"`

    The status of the quota, i.e. 'ACTIVE' or 'INACTIVE'

    - `"ACTIVE"`

    - `"INACTIVE"`

  - `id: optional string`

    The system-generated UUID for the quota

  - `created_at: optional string`

    The creation date of the quota configuration in the database

  - `ended_at: optional string`

    The end date of the quota

  - `idempotency_key: optional string`

    The idempotency key

  - `started_at: optional string`

    The start date of the quota

  - `updated_at: optional string`

    The last updated date of the quota configuration in the database

- `page: number`

- `pages: number`

- `size: number`

- `total: number`

### Example

```http
curl https://api.cloud.llamaindex.ai/api/v1/beta/quota-management \
    -H "Authorization: Bearer $LLAMA_CLOUD_API_KEY"
```

#### Response

```json
{
  "items": [
    {
      "configuration_metadata": {
        "foo": "bar"
      },
      "configuration_type": "allow_pay_as_you_go",
      "configuration_value": {
        "numerator": 0,
        "denominator": 0,
        "denominator_units": "day"
      },
      "source_id": "source_id",
      "source_type": "GLOBAL",
      "status": "ACTIVE",
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "created_at": "2019-12-27T18:11:19.117Z",
      "ended_at": "2019-12-27T18:11:19.117Z",
      "idempotency_key": "idempotency_key",
      "started_at": "2019-12-27T18:11:19.117Z",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "page": 0,
  "pages": 0,
  "size": 0,
  "total": 0
}
```
