{
  "openapi": "3.1.0",
  "info": {
    "title": "Psych Dictionary API",
    "version": "1.0.0",
    "description": "Read-only JSON API for Psych Dictionary, a reference library of psychology and therapy.\n\nNo key is required. Every response is public, cacheable and served with `Access-Control-Allow-Origin: *`.\n\nAttribution: cite the canonical `url` of each entry used. Entries are educational reference material; they do not diagnose or recommend treatment.\n\nThe same data is available to AI agents through the MCP server at https://www.psychdictionary.com/mcp and as Agent Skills at https://www.psychdictionary.com/skills/index.json.",
    "termsOfService": "https://www.psychdictionary.com/developers#terms",
    "contact": {
      "url": "https://www.psychdictionary.com/about"
    }
  },
  "security": [],
  "servers": [
    {
      "url": "https://www.psychdictionary.com"
    }
  ],
  "externalDocs": {
    "description": "Developer documentation",
    "url": "https://www.psychdictionary.com/developers"
  },
  "tags": [
    {
      "name": "Meta",
      "description": "Discovery."
    },
    {
      "name": "Search",
      "description": "Full-text search."
    },
    {
      "name": "Entries",
      "description": "Therapies, concepts, methods, figures, topics and comparisons."
    },
    {
      "name": "Topics",
      "description": "Groupings of entries."
    }
  ],
  "paths": {
    "/api/v1": {
      "get": {
        "operationId": "getIndex",
        "summary": "API index",
        "description": "Names every endpoint, with links to this specification, the developer page, the MCP endpoint and the skills index.",
        "tags": [
          "Meta"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Public, cacheable."
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "60 requests per 60 seconds per IP."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiIndex"
                }
              }
            }
          },
          "400": {
            "description": "A parameter is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded. Wait for the number of seconds in Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-example-url": "https://www.psychdictionary.com/api/v1"
      }
    },
    "/api/v1/search": {
      "get": {
        "operationId": "search",
        "summary": "Full-text search",
        "description": "Searches titles, abbreviations, older names, summaries and entry text, the same index the site search page uses. Each result names the section its excerpt came from.\n\nMCP equivalent: the `search` tool at https://www.psychdictionary.com/mcp.",
        "tags": [
          "Search"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search text: a term, an abbreviation, an older name, a person or a phrase.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Entry type: therapy, concept, method, figure, topic or comparison.",
            "schema": {
              "type": "string",
              "enum": [
                "therapy",
                "concept",
                "method",
                "figure",
                "topic",
                "comparison"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results per page (1–25).",
            "schema": {
              "default": 10,
              "type": "integer",
              "minimum": 1,
              "maximum": 25
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Page number, from 1.",
            "schema": {
              "default": 1,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Public, cacheable."
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "60 requests per 60 seconds per IP."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResults"
                }
              }
            }
          },
          "400": {
            "description": "A parameter is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded. Wait for the number of seconds in Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-example-url": "https://www.psychdictionary.com/api/v1/search?q=transference"
      }
    },
    "/api/v1/entries": {
      "get": {
        "operationId": "listEntries",
        "summary": "List entries",
        "description": "Lists published entries in title order, filtered by type, topic or index letter.\n\nMCP equivalent: the `list_entries` tool at https://www.psychdictionary.com/mcp.",
        "tags": [
          "Entries"
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Entry type: therapy, concept, method, figure, topic or comparison.",
            "schema": {
              "type": "string",
              "enum": [
                "therapy",
                "concept",
                "method",
                "figure",
                "topic",
                "comparison"
              ]
            }
          },
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "description": "Topic slug, e.g. behaviorism. Lists the entries filed under that topic.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120,
              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
            }
          },
          {
            "name": "letter",
            "in": "query",
            "required": false,
            "description": "Index letter of the title, as on the A–Z page. Use %23 for #.",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z#]$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Entries per page (1–500).",
            "schema": {
              "default": 100,
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of entries to skip.",
            "schema": {
              "default": 0,
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Public, cacheable."
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "60 requests per 60 seconds per IP."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntryList"
                }
              }
            }
          },
          "400": {
            "description": "A parameter is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded. Wait for the number of seconds in Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-example-url": "https://www.psychdictionary.com/api/v1/entries?type=therapy&topic=trauma-therapies"
      }
    },
    "/api/v1/entries/{type}/{slug}": {
      "get": {
        "operationId": "getEntry",
        "summary": "Get one entry",
        "description": "One published entry: In short, definition, key facts, evidence label and summary, the text by section as Markdown, numbered sources with DOIs, related entries, dates, citation strings and the canonical URL.\n\nMCP equivalent: the `get_entry` tool at https://www.psychdictionary.com/mcp.",
        "tags": [
          "Entries"
        ],
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "description": "Entry type (therapy, concept, method, figure, topic, comparison) or its URL segment (therapies, concepts, methods, figures, topics, compare).",
            "schema": {
              "type": "string",
              "enum": [
                "therapy",
                "concept",
                "method",
                "figure",
                "topic",
                "comparison",
                "therapies",
                "concepts",
                "methods",
                "figures",
                "topics",
                "compare"
              ]
            }
          },
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Entry slug: the last segment of the entry URL, e.g. cognitive-behavioral-therapy.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120,
              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Public, cacheable."
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "60 requests per 60 seconds per IP."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntryDetail"
                }
              }
            }
          },
          "400": {
            "description": "A parameter is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "No published item has that identifier.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded. Wait for the number of seconds in Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-example-url": "https://www.psychdictionary.com/api/v1/entries/concept/classical-conditioning"
      }
    },
    "/api/v1/topics": {
      "get": {
        "operationId": "listTopics",
        "summary": "List topics",
        "description": "Lists the topics (schools, perspectives and research areas) that group entries, with the number of entries in each.\n\nMCP equivalent: the `list_topics` tool at https://www.psychdictionary.com/mcp.",
        "tags": [
          "Topics"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                },
                "description": "Public, cacheable."
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "60 requests per 60 seconds per IP."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TopicList"
                }
              }
            }
          },
          "400": {
            "description": "A parameter is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded. Wait for the number of seconds in Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-example-url": "https://www.psychdictionary.com/api/v1/topics"
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "status": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "code": {
                "type": "string",
                "description": "Stable machine-readable code: invalid_request, not_found, method_not_allowed, rate_limited, internal_error."
              },
              "message": {
                "type": "string"
              },
              "details": {}
            },
            "required": [
              "status",
              "code",
              "message"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "error"
        ],
        "additionalProperties": false
      },
      "ApiIndex": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "documentation": {
            "type": "string",
            "description": "Absolute URL."
          },
          "openapi": {
            "type": "string",
            "description": "Absolute URL."
          },
          "mcp": {
            "type": "string",
            "description": "Absolute URL."
          },
          "skills": {
            "type": "string",
            "description": "Absolute URL."
          },
          "endpoints": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "method": {
                  "type": "string",
                  "const": "GET"
                },
                "path": {
                  "type": "string"
                },
                "summary": {
                  "type": "string"
                },
                "example": {
                  "type": "string",
                  "description": "Absolute URL."
                }
              },
              "required": [
                "method",
                "path",
                "summary",
                "example"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "name",
          "description",
          "version",
          "documentation",
          "openapi",
          "mcp",
          "skills",
          "endpoints"
        ],
        "additionalProperties": false
      },
      "SearchResults": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "total": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "page": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "pageCount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "countsByType": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "description": "Matches per entry type, across all types."
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "therapy",
                    "concept",
                    "method",
                    "figure",
                    "topic",
                    "comparison"
                  ]
                },
                "slug": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "abbreviation": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "excerpt": {
                  "type": "string",
                  "description": "Matching text from the summary or a section."
                },
                "section": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "heading": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string",
                          "description": "Absolute URL."
                        }
                      },
                      "required": [
                        "heading",
                        "url"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The section the excerpt came from, when it is not the summary."
                },
                "url": {
                  "type": "string",
                  "description": "Canonical page URL. Cite this."
                },
                "apiUrl": {
                  "type": "string",
                  "description": "Absolute URL."
                }
              },
              "required": [
                "type",
                "slug",
                "title",
                "abbreviation",
                "excerpt",
                "section",
                "url",
                "apiUrl"
              ],
              "additionalProperties": false
            }
          },
          "suggestions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Spelling suggestions, filled only when nothing matched."
          },
          "closeMatches": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "description": "Absolute URL."
                }
              },
              "required": [
                "title",
                "url"
              ],
              "additionalProperties": false
            },
            "description": "Near matches, filled only when nothing matched."
          }
        },
        "required": [
          "query",
          "type",
          "total",
          "page",
          "pageCount",
          "countsByType",
          "results",
          "suggestions",
          "closeMatches"
        ],
        "additionalProperties": false
      },
      "EntryList": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Entries matching the filters."
          },
          "offset": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "limit": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "filters": {
            "type": "object",
            "properties": {
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "topic": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "letter": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "type",
              "topic",
              "letter"
            ],
            "additionalProperties": false
          },
          "entries": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "therapy",
                    "concept",
                    "method",
                    "figure",
                    "topic",
                    "comparison"
                  ]
                },
                "typeLabel": {
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "abbreviation": {
                  "description": "Abbreviation, when the entry has one.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "alternateNames": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Other names and older names for the subject."
                },
                "inShort": {
                  "type": "string",
                  "description": "The one-paragraph summary shown as \"In short\" at the top of the entry."
                },
                "evidenceStatus": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "strong",
                        "moderate",
                        "mixed",
                        "limited",
                        "historical"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Evidence label key; null where no label applies."
                },
                "evidenceLabel": {
                  "description": "Evidence label as shown on the page.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "topics": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string",
                        "description": "Absolute URL."
                      }
                    },
                    "required": [
                      "slug",
                      "title",
                      "url"
                    ],
                    "additionalProperties": false
                  }
                },
                "letter": {
                  "type": "string",
                  "description": "Index letter on the A–Z page."
                },
                "updatedAt": {
                  "description": "Date of the last substantive update, or of first publication (YYYY-MM-DD).",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": "string",
                  "description": "Canonical page URL. Cite this."
                },
                "apiUrl": {
                  "type": "string",
                  "description": "Absolute URL."
                }
              },
              "required": [
                "type",
                "typeLabel",
                "slug",
                "title",
                "abbreviation",
                "alternateNames",
                "inShort",
                "evidenceStatus",
                "evidenceLabel",
                "topics",
                "letter",
                "updatedAt",
                "url",
                "apiUrl"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "total",
          "offset",
          "limit",
          "filters",
          "entries"
        ],
        "additionalProperties": false
      },
      "EntryDetail": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "therapy",
              "concept",
              "method",
              "figure",
              "topic",
              "comparison"
            ]
          },
          "typeLabel": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "abbreviation": {
            "description": "Abbreviation, when the entry has one.",
            "type": [
              "string",
              "null"
            ]
          },
          "alternateNames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Other names and older names for the subject."
          },
          "inShort": {
            "type": "string",
            "description": "The one-paragraph summary shown as \"In short\" at the top of the entry."
          },
          "evidenceStatus": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "strong",
                  "moderate",
                  "mixed",
                  "limited",
                  "historical"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Evidence label key; null where no label applies."
          },
          "evidenceLabel": {
            "description": "Evidence label as shown on the page.",
            "type": [
              "string",
              "null"
            ]
          },
          "topics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "description": "Absolute URL."
                }
              },
              "required": [
                "slug",
                "title",
                "url"
              ],
              "additionalProperties": false
            }
          },
          "letter": {
            "type": "string",
            "description": "Index letter on the A–Z page."
          },
          "updatedAt": {
            "description": "Date of the last substantive update, or of first publication (YYYY-MM-DD).",
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "description": "Canonical page URL. Cite this."
          },
          "apiUrl": {
            "type": "string",
            "description": "Absolute URL."
          },
          "fullName": {
            "description": "Full name, for figures.",
            "type": [
              "string",
              "null"
            ]
          },
          "definition": {
            "type": "string",
            "description": "The opening paragraph of the entry, which defines the subject."
          },
          "keyFacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "value": {
                  "type": "string"
                },
                "entries": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "therapy",
                          "concept",
                          "method",
                          "figure",
                          "topic",
                          "comparison"
                        ]
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "abbreviation": {
                        "description": "Abbreviation, when the entry has one.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "url": {
                        "type": "string",
                        "description": "Canonical page URL. Cite this."
                      },
                      "apiUrl": {
                        "type": "string",
                        "description": "This entry in the API."
                      }
                    },
                    "required": [
                      "type",
                      "slug",
                      "title",
                      "abbreviation",
                      "url",
                      "apiUrl"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Entries the fact links to, if any."
                }
              },
              "required": [
                "label",
                "value",
                "entries"
              ],
              "additionalProperties": false
            },
            "description": "The key-facts table at the top of the entry."
          },
          "evidence": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "strong",
                      "moderate",
                      "mixed",
                      "limited",
                      "historical"
                    ]
                  },
                  "label": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string",
                    "description": "What the label means (editorial standards)."
                  },
                  "summaryMarkdown": {
                    "description": "The \"State of the evidence\" text for this entry.",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "status",
                  "label",
                  "description",
                  "summaryMarkdown"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "Evidence label and summary; null where no label applies. Labels summarise the literature and are not recommendations."
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "description": "Anchor id of the heading on the page; null for the text before the first heading.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "heading": {
                  "description": "Section heading; null for the opening text.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": "string",
                  "description": "Deep link to the section."
                },
                "markdown": {
                  "type": "string",
                  "description": "Section text as Markdown. [n] marks a citation to sources[n-1]. Links are absolute."
                }
              },
              "required": [
                "id",
                "heading",
                "url",
                "markdown"
              ],
              "additionalProperties": false
            }
          },
          "comparison": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "columns": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "rows": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "dimension": {
                          "type": "string"
                        },
                        "first": {
                          "type": "string"
                        },
                        "second": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "dimension",
                        "first",
                        "second"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "columns",
                  "rows"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "The comparison table, for comparison entries."
          },
          "members": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "therapy",
                    "concept",
                    "method",
                    "figure",
                    "topic",
                    "comparison"
                  ]
                },
                "slug": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "abbreviation": {
                  "description": "Abbreviation, when the entry has one.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": "string",
                  "description": "Canonical page URL. Cite this."
                },
                "apiUrl": {
                  "type": "string",
                  "description": "This entry in the API."
                }
              },
              "required": [
                "type",
                "slug",
                "title",
                "abbreviation",
                "url",
                "apiUrl"
              ],
              "additionalProperties": false
            },
            "description": "Entries filed under this topic, for topic entries."
          },
          "keyWorks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "number": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The number used for in-text citations ([n]) in this entry; null for key works and further reading."
                },
                "sourceType": {
                  "type": "string",
                  "enum": [
                    "article",
                    "book",
                    "chapter",
                    "report",
                    "web"
                  ]
                },
                "citation": {
                  "type": "string",
                  "description": "Formatted reference, close to APA 7."
                },
                "title": {
                  "type": "string"
                },
                "authors": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "year": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Publication year."
                },
                "container": {
                  "description": "Journal or book title.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "publisher": {
                  "description": "Publisher.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "doi": {
                  "description": "DOI, without the resolver prefix.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "isbn": {
                  "description": "ISBN.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "link": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Absolute URL."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "https://doi.org/… when a DOI exists, otherwise the source URL."
                }
              },
              "required": [
                "number",
                "sourceType",
                "citation",
                "title",
                "authors",
                "year",
                "container",
                "publisher",
                "doi",
                "isbn",
                "link"
              ],
              "additionalProperties": false
            },
            "description": "Key works, for figures."
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "number": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The number used for in-text citations ([n]) in this entry; null for key works and further reading."
                },
                "sourceType": {
                  "type": "string",
                  "enum": [
                    "article",
                    "book",
                    "chapter",
                    "report",
                    "web"
                  ]
                },
                "citation": {
                  "type": "string",
                  "description": "Formatted reference, close to APA 7."
                },
                "title": {
                  "type": "string"
                },
                "authors": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "year": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Publication year."
                },
                "container": {
                  "description": "Journal or book title.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "publisher": {
                  "description": "Publisher.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "doi": {
                  "description": "DOI, without the resolver prefix.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "isbn": {
                  "description": "ISBN.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "link": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Absolute URL."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "https://doi.org/… when a DOI exists, otherwise the source URL."
                }
              },
              "required": [
                "number",
                "sourceType",
                "citation",
                "title",
                "authors",
                "year",
                "container",
                "publisher",
                "doi",
                "isbn",
                "link"
              ],
              "additionalProperties": false
            },
            "description": "Numbered in order of first citation, as on the page."
          },
          "furtherReading": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "number": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The number used for in-text citations ([n]) in this entry; null for key works and further reading."
                },
                "sourceType": {
                  "type": "string",
                  "enum": [
                    "article",
                    "book",
                    "chapter",
                    "report",
                    "web"
                  ]
                },
                "citation": {
                  "type": "string",
                  "description": "Formatted reference, close to APA 7."
                },
                "title": {
                  "type": "string"
                },
                "authors": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "year": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Publication year."
                },
                "container": {
                  "description": "Journal or book title.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "publisher": {
                  "description": "Publisher.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "doi": {
                  "description": "DOI, without the resolver prefix.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "isbn": {
                  "description": "ISBN.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "link": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Absolute URL."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "https://doi.org/… when a DOI exists, otherwise the source URL."
                }
              },
              "required": [
                "number",
                "sourceType",
                "citation",
                "title",
                "authors",
                "year",
                "container",
                "publisher",
                "doi",
                "isbn",
                "link"
              ],
              "additionalProperties": false
            }
          },
          "related": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "therapy",
                    "concept",
                    "method",
                    "figure",
                    "topic",
                    "comparison"
                  ]
                },
                "slug": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "abbreviation": {
                  "description": "Abbreviation, when the entry has one.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": "string",
                  "description": "Canonical page URL. Cite this."
                },
                "apiUrl": {
                  "type": "string",
                  "description": "This entry in the API."
                }
              },
              "required": [
                "type",
                "slug",
                "title",
                "abbreviation",
                "url",
                "apiUrl"
              ],
              "additionalProperties": false
            }
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reviewers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "credentials": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "name",
                "credentials"
              ],
              "additionalProperties": false
            },
            "description": "Named reviewers. Empty when no review has taken place."
          },
          "publishedAt": {
            "description": "First publication date.",
            "type": [
              "string",
              "null"
            ]
          },
          "changeNote": {
            "description": "What the last substantive update changed.",
            "type": [
              "string",
              "null"
            ]
          },
          "cite": {
            "type": "object",
            "properties": {
              "apa": {
                "type": "string"
              },
              "mla": {
                "type": "string"
              }
            },
            "required": [
              "apa",
              "mla"
            ],
            "additionalProperties": false,
            "description": "Citation strings as shown under \"Cite this entry\"."
          },
          "disclaimer": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "typeLabel",
          "slug",
          "title",
          "abbreviation",
          "alternateNames",
          "inShort",
          "evidenceStatus",
          "evidenceLabel",
          "topics",
          "letter",
          "updatedAt",
          "url",
          "apiUrl",
          "fullName",
          "definition",
          "keyFacts",
          "evidence",
          "sections",
          "comparison",
          "members",
          "keyWorks",
          "sources",
          "furtherReading",
          "related",
          "authors",
          "reviewers",
          "publishedAt",
          "changeNote",
          "cite",
          "disclaimer"
        ],
        "additionalProperties": false
      },
      "TopicList": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "topics": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "inShort": {
                  "type": "string"
                },
                "period": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "entryCount": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Published entries filed under the topic."
                },
                "url": {
                  "type": "string",
                  "description": "Absolute URL."
                },
                "apiUrl": {
                  "type": "string",
                  "description": "The topic entry itself (with its member list)."
                },
                "entriesApiUrl": {
                  "type": "string",
                  "description": "The entries filed under the topic."
                }
              },
              "required": [
                "slug",
                "title",
                "inShort",
                "period",
                "entryCount",
                "url",
                "apiUrl",
                "entriesApiUrl"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "total",
          "topics"
        ],
        "additionalProperties": false
      }
    }
  }
}