Skip to content
LlamaCloud Admin API
Product Docs
API Reference
Quota Management

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 ParametersExpand Collapse
source_id: string
source_type: "GLOBAL" or "organization" or "plan_tier" or "project"
One of the following:
"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
One of the following:
"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 ParametersExpand Collapse
session: optional string
ReturnsExpand Collapse
items: array of QuotaConfiguration { configuration_metadata, configuration_type, configuration_value, 9 more }
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

One of the following:
"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

One of the following:
"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’

One of the following:
"GLOBAL"
"organization"
"plan_tier"
"project"
status: "ACTIVE" or "INACTIVE"

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

One of the following:
"ACTIVE"
"INACTIVE"
id: optional string

The system-generated UUID for the quota

formatuuid
created_at: optional string

The creation date of the quota configuration in the database

formatdate-time
ended_at: optional string

The end date of the quota

formatdate-time
idempotency_key: optional string

The idempotency key

started_at: optional string

The start date of the quota

formatdate-time
updated_at: optional string

The last updated date of the quota configuration in the database

formatdate-time
page: number
pages: number
size: number
total: number

List quota configurations

curl https://api.cloud.llamaindex.ai/api/v1/beta/quota-management \
    -H "Authorization: Bearer $LLAMA_CLOUD_API_KEY"
{
  "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
}
Returns Examples
{
  "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
}