Skip to main content
GET
/
v1
/
citation_schemas
Get Citation Schema
curl --request GET \
  --url https://api.bland.ai/v1/citation_schemas/ \
  --header 'authorization: <authorization>'
{
  "status": 200,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Customer Information Extraction",
    "description": "Extracts customer demographics and contact information from call transcripts",
    "org_id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
    "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"
        },
        {
          "name": "Interested in Product",
          "description": "Whether the customer expressed interest in the product",
          "type": "boolean"
        }
      ],
      "groupings": [
        {
          "name": "Demographics",
          "variables": ["Customer Name", "Customer Age"]
        }
      ],
      "conditions": [
        {
          "condition": {
            "value": "true",
            "operator": "===",
            "variable": "Interested in Product"
          },
          "variables": [
            {
              "name": "Product Interest Details",
              "type": "string",
              "description": "Specific details about which product features interest the customer"
            }
          ]
        }
      ]
    },
    "created_at": "2023-12-15T14:30:00.000Z"
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Query Parameters

​
id
string
required
The unique identifier of the citation schema to retrieve.

​
Response

​
status
integer
HTTP status code (200 for success).
​
data
object
The citation schema object.
​
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.
​
org_id
string
The organization ID that owns this schema.
​
schema
object
The JSON schema configuration containing variables, groupings, and conditions for citation extraction.
​
created_at
string
The timestamp when the citation schema was created (ISO 8601 format).
​
errors
null
Will be null for successful requests.

​
Error Responses

​
400 Bad Request
Returned when the schema ID parameter is missing.
​
404 Not Found
Returned when the specified citation schema is not found or doesn’t belong to your organization.
{
  "status": 200,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Customer Information Extraction",
    "description": "Extracts customer demographics and contact information from call transcripts",
    "org_id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
    "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"
        },
        {
          "name": "Interested in Product",
          "description": "Whether the customer expressed interest in the product",
          "type": "boolean"
        }
      ],
      "groupings": [
        {
          "name": "Demographics",
          "variables": ["Customer Name", "Customer Age"]
        }
      ],
      "conditions": [
        {
          "condition": {
            "value": "true",
            "operator": "===",
            "variable": "Interested in Product"
          },
          "variables": [
            {
              "name": "Product Interest Details",
              "type": "string",
              "description": "Specific details about which product features interest the customer"
            }
          ]
        }
      ]
    },
    "created_at": "2023-12-15T14:30:00.000Z"
  },
  "errors": null
}
Docs for agents: llms.txt