System REST API API

{"openapi": "3.1.0", "info": {"title": "System REST API", "description": "\nThis page provides documentation for the System REST API.\n\nIf you have any questions or need support, please contact us at the email provided.\n\n## Formatting query parameters\n\nFilters should be formatted as `field:value` and use the logical OR operator `||` to specify an OR condition. (We've deprecated the pipe operator for OR conditions.) \n\nIf they are numerical, they should be formatted as `field:opvalue`. Examples:\n- `doi:10.1234/5678||10.8765/4321`\n- `num_findings:>2`\n\nSorts should be formatted as `field:direction`. Examples:\n- `cited_by:desc`\n- `publish_date:asc`\n\nSearches should be formatted as `field:value`. Examples:\n- `name:osteoporosis`\n", "contact": {"name": "System API Team", "url": "https://systemtechnologies.atlassian.net/servicedesk/customer/portal/4", "email": "api@system.com"}, "version": "0.1.0"}, "servers": [{"url": "https://api-prod.system.com", "description": "Production API"}, {"url": "https://api-stage.system.com", "description": "Staging API"}, {"url": "https://api-dev.system.com", "description": "Development API"}, {"url": "/", "description": "Local API"}], "paths": {"/v0/topics/{topic_id}": {"get": {"tags": ["Topics"], "summary": "Get a topic", "description": "Get a topic by its ID.", "operationId": "get_topic_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Topic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics": {"get": {"tags": ["Topics"], "summary": "Get topics", "description": "Get a list of topics.", "operationId": "get_topics", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, wikidata_id, umls_cuis, category, roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, wikidata_id, umls_cuis, category, roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Topic_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/variables": {"get": {"tags": ["Topics"], "summary": "Get topic variables", "description": "Get a list of the variables that have been matched to a given topic.", "operationId": "get_topic_variables", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_studies, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_studies, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_studies.", "default": "num_studies:desc", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_studies."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Variable_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/relationships": {"get": {"tags": ["Topics"], "summary": "Get topic relationships", "description": "Get a list of the relationships that include a given topic as the source or target topic.", "operationId": "get_topic_relationships", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, source_topic.id, source_topic.wikidata_id, source_topic.umls_cuis, source_topic.category, source_topic.roles, target_topic.id, target_topic.wikidata_id, target_topic.umls_cuis, target_topic.category, target_topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, source_topic.id, source_topic.wikidata_id, source_topic.umls_cuis, source_topic.category, source_topic.roles, target_topic.id, target_topic.wikidata_id, target_topic.umls_cuis, target_topic.category, target_topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: source_topic.name, target_topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: source_topic.name, target_topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Relationship_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/determinants": {"get": {"tags": ["Topics"], "summary": "Get topic determinants", "description": "Get a list of determinants for a given topic.\nThese are formatted as `TopicPath`s, which include data about the relationship and the source topic.", "operationId": "get_topic_determinants", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_TopicPath_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/interventions": {"get": {"tags": ["Topics"], "summary": "Get topic interventions", "description": "Get a list of interventions for a given topic.\nThese are formatted as `TopicPath`s, which include data about the relationship and the source topic.", "operationId": "get_topic_interventions", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_TopicPath_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/outcomes": {"get": {"tags": ["Topics"], "summary": "Get topic outcomes", "description": "Get a list of outcomes for a given topic.\nThese are formatted as `TopicPath`s, which include data about the relationship and the target topic.", "operationId": "get_topic_outcomes", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_TopicPath_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/studies/{study_id}": {"get": {"tags": ["Studies"], "summary": "Get a study", "description": "Get a study by its ID.", "operationId": "get_study_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "study_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Study Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Study"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/studies": {"get": {"tags": ["Studies"], "summary": "Get studies", "description": "Get a list of studies.", "operationId": "get_studies", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: none.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: none."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Study_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/studies/{study_id}/statistical_findings": {"get": {"tags": ["Studies"], "summary": "Get study statistical findings", "description": "Get a list of the statistical findings reported by a given study.", "operationId": "get_study_statistical_findings", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "study_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Study Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatisticalFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/statistical_findings/{finding_id}": {"get": {"tags": ["Statistical Findings"], "summary": "Get a statistical finding", "description": "Get a statistical finding by its ID.", "operationId": "get_statistical_finding_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "finding_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Finding Id"}}], "responses": {"200": {"description": "Statistical Finding object", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/StatisticalFinding"}}}}, "404": {"description": "Not found"}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/statistical_findings": {"get": {"tags": ["Statistical Findings"], "summary": "Get statistical findings", "description": "Get a list of statistical findings.", "operationId": "get_statistical_findings", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "List of Statistical Findings", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatisticalFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/statistical_findings/{finding_id}/flags": {"post": {"tags": ["Statistical Findings"], "summary": "Flag statistical finding", "description": "Flag a statistical finding for review.", "operationId": "flag_statistical_finding", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "finding_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Finding Id"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "array", "items": {"$ref": "#/components/schemas/FlagInput"}, "title": "Flags"}}}}, "r

# --- truncated at 32 KB (101 KB total) ---
# Full source: https://artifacts.apis.io/system/openapi/_original/system-api-openapi.json