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

# List Citation Schemas

> Retrieve all citation schemas for your organization, including each schema's variables, groupings, and conditions.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Response

**status** `integer`

HTTP status code (200 for success).

**data** `array`

An array of citation schema objects.

**id** `string`

The unique identifier for the citation schema (UUID format).

**name** `string`

The name of the citation schema.

**description** `string`

The description of the citation schema.

**schema** `object`

The JSON schema configuration containing variables, groupings, and conditions for citation extraction. Returned inline so you can enumerate fields without a follow-up request per schema.

**created\_at** `string`

The timestamp when the citation schema was created (ISO 8601 format).

**errors** `null`

Will be null for successful requests.

```json Response theme={null}
{
  "status": 200,
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "name": "Customer Information Extraction",
      "description": "Extracts customer demographics and contact information from call transcripts",
      "schema": {
        "variables": [
          {
            "name": "Customer Name",
            "description": "The full name of the customer",
            "type": "string"
          },
          {
            "name": "Customer Age",
            "description": "The age of the customer in years",
            "type": "number"
          }
        ],
        "groupings": [
          {
            "name": "Demographics",
            "variables": ["Customer Name", "Customer Age"]
          }
        ],
        "conditions": []
      },
      "created_at": "2023-12-15T14:30:00.000Z"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "Lead Qualification Schema",
      "description": "Identifies qualified leads and their interest levels",
      "schema": {
        "variables": [
          {
            "name": "Qualified Lead",
            "description": "Whether the caller meets qualification criteria",
            "type": "boolean"
          }
        ],
        "groupings": [],
        "conditions": []
      },
      "created_at": "2023-12-10T09:15:30.000Z"
    }
  ],
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.