Skip to main content
GET
/
v1
/
citation_schemas
/
list
List Citation Schemas
curl --request GET \
  --url https://api.bland.ai/v1/citation_schemas/list \
  --header 'authorization: <authorization>'
{
  "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
}

​
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.
{
  "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