{"openapi":"3.1.0","info":{"title":"Psychedelics Knowledge Graph API","summary":"Programmatic access to Psychedelics Knowledge Graph.","description":"Search papers, concepts, externally identified authors, and deduplicated paper-level relationships. Primary studies, meta-analyses, and reviews are classified separately. Granular extracted findings, statistics, quotes, and internal curation fields are intentionally not public.","version":"1.0.0"},"servers":[{"url":"/","description":"Current service origin"}],"paths":{"/":{"get":{"tags":["service"],"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Root  Get"}}}}}}},"/api/v1":{"get":{"tags":["service"],"summary":"Api Index","operationId":"api_index_api_v1_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Api Index Api V1 Get"}}}}}}},"/healthz":{"get":{"tags":["service"],"summary":"Health","description":"Confirm that the web process can accept requests.","operationId":"health_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Healthz Get"}}}}}}},"/readyz":{"get":{"tags":["service"],"summary":"Readiness","description":"Confirm that the research database is ready for queries.","operationId":"readiness_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/meta":{"get":{"tags":["release"],"summary":"Meta","operationId":"meta_api_v1_meta_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Meta Api V1 Meta Get"}}}}}}},"/api/v1/schema":{"get":{"tags":["release"],"summary":"Schema","operationId":"schema_api_v1_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Schema Api V1 Schema Get"}}}}}}},"/api/v1/facets":{"get":{"tags":["catalogue"],"summary":"Facets","operationId":"facets_api_v1_facets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Facets Api V1 Facets Get"}}}}}}},"/api/v1/concepts/search":{"get":{"tags":["concepts"],"summary":"Search Concepts","operationId":"search_concepts_api_v1_concepts_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"concept_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Match kinds observed at either endpoint of public relationships.","title":"Concept Kind"},"description":"Match kinds observed at either endpoint of public relationships."},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Match domains observed on public relationships involving the concept.","title":"Domain"},"description":"Match domains observed on public relationships involving the concept."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":15,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Concepts Api V1 Concepts Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/concepts/{concept_id}":{"get":{"tags":["concepts"],"summary":"Get Concept","operationId":"get_concept_api_v1_concepts__concept_id__get","parameters":[{"name":"concept_id","in":"path","required":true,"schema":{"type":"string","title":"Concept Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Concept Api V1 Concepts  Concept Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/authors/search":{"get":{"tags":["authors"],"summary":"Search Authors","operationId":"search_authors_api_v1_authors_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":15,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Authors Api V1 Authors Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/authors/{author_id}":{"get":{"tags":["authors"],"summary":"Get Author","operationId":"get_author_api_v1_authors__author_id__get","parameters":[{"name":"author_id","in":"path","required":true,"schema":{"type":"string","title":"Author Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Author Api V1 Authors  Author Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/authors/{author_id}/papers":{"get":{"tags":["authors","papers"],"summary":"Get Author Papers","operationId":"get_author_papers_api_v1_authors__author_id__papers_get","parameters":[{"name":"author_id","in":"path","required":true,"schema":{"type":"string","title":"Author Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Author Papers Api V1 Authors  Author Id  Papers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/papers/query":{"post":{"tags":["papers"],"summary":"Query Papers","operationId":"query_papers_api_v1_papers_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaperQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Query Papers Api V1 Papers Query Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/papers/{paper_id_or_doi}":{"get":{"tags":["papers"],"summary":"Get Paper","operationId":"get_paper_api_v1_papers__paper_id_or_doi__get","parameters":[{"name":"paper_id_or_doi","in":"path","required":true,"schema":{"type":"string","title":"Paper Id Or Doi"}},{"name":"include_relationships","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Relationships"}},{"name":"relationship_limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Relationship Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Paper Api V1 Papers  Paper Id Or Doi  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/relationships/query":{"post":{"tags":["relationships"],"summary":"Query Relationships","operationId":"query_relationships_api_v1_relationships_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationshipQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Query Relationships Api V1 Relationships Query Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PaperFilters":{"properties":{"year_from":{"anyOf":[{"type":"integer","maximum":2200.0,"minimum":1800.0},{"type":"null"}],"title":"Year From"},"year_to":{"anyOf":[{"type":"integer","maximum":2200.0,"minimum":1800.0},{"type":"null"}],"title":"Year To"},"query":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Query","description":"Case-insensitive match across title, DOI, journal, and credited author names."},"paper_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Paper Ids"},"dois":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Dois"},"paper_types":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Paper Types"},"paper_subtypes":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Paper Subtypes"},"author_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Author Ids"},"author_names":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Author Names"},"concept_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Concept Ids","description":"Match ANY listed concept at either endpoint, not all concepts together."},"subject_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Subject Ids","description":"Match a relationship subject ID; all relationship filters must match the same relationship."},"object_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Object Ids","description":"Match a relationship object ID; use with subject_ids for a compound–outcome pair."},"subject_labels":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Subject Labels","description":"Match papers with an exact relationship subject label. Prefer subject IDs for durable integrations."},"object_labels":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Object Labels","description":"Match papers with an exact relationship object label. Prefer object IDs for durable integrations."},"domains":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Domains"},"relation_types":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Relation Types"},"subject_kinds":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Subject Kinds","description":"Match papers with a relationship whose subject has one of these contextual kinds."},"object_kinds":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Object Kinds","description":"Match papers with a relationship whose object has one of these contextual kinds."}},"additionalProperties":false,"type":"object","title":"PaperFilters","description":"OR within lists, AND across fields; relationship fields match one relationship."},"PaperQuery":{"properties":{"filters":{"$ref":"#/components/schemas/PaperFilters"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":25},"cursor":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},"additionalProperties":false,"type":"object","title":"PaperQuery"},"RelationshipFilters":{"properties":{"year_from":{"anyOf":[{"type":"integer","maximum":2200.0,"minimum":1800.0},{"type":"null"}],"title":"Year From"},"year_to":{"anyOf":[{"type":"integer","maximum":2200.0,"minimum":1800.0},{"type":"null"}],"title":"Year To"},"paper_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Paper Ids"},"dois":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Dois"},"paper_types":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Paper Types"},"paper_subtypes":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Paper Subtypes"},"author_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Author Ids"},"author_names":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Author Names"},"concept_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Concept Ids","description":"Match ANY listed concept at either endpoint, not all concepts together."},"subject_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Subject Ids"},"object_ids":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Object Ids"},"subject_labels":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Subject Labels","description":"Match an exact subject label. Prefer subject IDs for durable integrations."},"object_labels":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Object Labels","description":"Match an exact object label. Prefer object IDs for durable integrations."},"domains":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Domains"},"relation_types":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Relation Types"},"subject_kinds":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Subject Kinds","description":"Match the relationship-scoped subject kind."},"object_kinds":{"items":{"type":"string","maxLength":500},"type":"array","maxItems":100,"title":"Object Kinds","description":"Match the relationship-scoped object kind."}},"additionalProperties":false,"type":"object","title":"RelationshipFilters","description":"OR within lists, AND across fields on the same relationship."},"RelationshipQuery":{"properties":{"filters":{"$ref":"#/components/schemas/RelationshipFilters"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":25},"cursor":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},"additionalProperties":false,"type":"object","title":"RelationshipQuery"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"externalDocs":{"description":"API guide","url":"https://psychedelicskg.com/api/"}}