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

List quota configurations

quota_management.list(QuotaManagementListParams**kwargs) -> SyncPaginatedPageNumber[QuotaConfiguration]
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.

ParametersExpand Collapse
source_id: str
source_type: Literal["GLOBAL", "organization", "plan_tier", "project"]
One of the following:
"GLOBAL"
"organization"
"plan_tier"
"project"
configuration_type: Optional[Literal["allow_pay_as_you_go", "limit_agent_coder_daily_usage_usd", "limit_agent_deployments", 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[bool]
expand: Optional[bool]
page: Optional[int]
page_size: Optional[int]
ReturnsExpand Collapse
class QuotaConfiguration: …

Full quota configuration model.

configuration_metadata: Optional[Dict[str, object]]

The configuration metadata

configuration_type: Literal["allow_pay_as_you_go", "limit_agent_coder_daily_usage_usd", "limit_agent_deployments", 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: ConfigurationValue

The quota configuration value

numerator: int

The rate numerator

denominator: Optional[int]

The rate limit denominator

denominator_units: Optional[Literal["day", "hour", "minute", "second"]]

The default rate limit denominator units

One of the following:
"day"
"hour"
"minute"
"second"
source_id: str

The source ID, e.g. the organization ID

source_type: Literal["GLOBAL", "organization", "plan_tier", "project"]

The source type, e.g. ‘organization’

One of the following:
"GLOBAL"
"organization"
"plan_tier"
"project"
status: Literal["ACTIVE", "INACTIVE"]

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

One of the following:
"ACTIVE"
"INACTIVE"
id: Optional[str]

The system-generated UUID for the quota

formatuuid
created_at: Optional[datetime]

The creation date of the quota configuration in the database

formatdate-time
ended_at: Optional[datetime]

The end date of the quota

formatdate-time
idempotency_key: Optional[str]

The idempotency key

started_at: Optional[datetime]

The start date of the quota

formatdate-time
updated_at: Optional[datetime]

The last updated date of the quota configuration in the database

formatdate-time

List quota configurations

import os
from llama_cloud_admin import LlamaCloudAdmin

client = LlamaCloudAdmin(
    api_key=os.environ.get("LLAMA_CLOUD_API_KEY"),  # This is the default and can be omitted
)
page = client.quota_management.list(
    source_id="source_id",
    source_type="GLOBAL",
)
page = page.items[0]
print(page.source_id)
{
  "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
}