{"openapi":"3.1.0","servers":[{"url":"https://api.amass.tech"}],"info":{"version":"1.0.0","title":"Amass Technologies Data Platform API","description":"Programmatic access to **Amass Cores** — curated, enriched life-sciences datasets for\nbiomedical literature and clinical trials.\n\n## Base URL\n\n```\nhttps://api.amass.tech/api/v1\n```\n\n## Authentication\n\nAll endpoints require a Bearer token. Send your API key in the `Authorization` header\non every request:\n\n```http\nAuthorization: Bearer amass_<your-api-key>\n```\n\nGenerate and manage keys at [platform.amass.tech/api-keys](https://platform.amass.tech/api-keys).\n\n## Errors\n\nEvery error uses the same shape, with a machine-readable `code`:\n\n```json\n{\n  \"error\": {\n    \"status\": 400,\n    \"code\": \"BAD_REQUEST\",\n    \"message\": \"Human-readable description\"\n  }\n}\n```\n\n| Status | Code                    | Meaning                               |\n| ------ | ----------------------- | ------------------------------------- |\n| 400    | `BAD_REQUEST`           | Invalid parameters                    |\n| 401    | `UNAUTHORIZED`          | Missing or invalid API key            |\n| 403    | `FORBIDDEN`             | Valid key, insufficient permissions   |\n| 404    | `NOT_FOUND`             | Record not found                      |\n| 429    | `TOO_MANY_REQUESTS`     | Rate limited — respect `Retry-After`  |\n| 500    | `INTERNAL_SERVER_ERROR` | Server error                          |\n\nValidation errors include per-field details under `error.fields`.\n\n## Rate limits\n\n**60 requests / 60 seconds** per (user, organization). Every response includes:\n\n- `X-RateLimit-Limit`\n- `X-RateLimit-Remaining`\n- `X-RateLimit-Reset`\n\nWhen throttled, the API returns `429 TOO_MANY_REQUESTS` with a `Retry-After` header\n(seconds). Implement exponential backoff.\n\n## Pagination\n\nNo cursor or offset pagination. Each `/records` endpoint returns up to **300** results\nvia the `limit` parameter — narrow large result sets with filters rather than paging.\n\n## Help\n\n- [Full Overview](https://platform.amass.tech/documentation/overview)\n- [Quickstart](https://platform.amass.tech/documentation/quickstart)\n- [LLM Quick Reference](https://platform.amass.tech/documentation/llm-quick-reference)\n"},"components":{"schemas":{"BiomedCoreRecord":{"type":"object","properties":{"amassId":{"type":"string"},"pmid":{"type":["string","null"],"description":"PubMed identifier — a unique numeric ID assigned by NLM to articles indexed in PubMed."},"pmcid":{"type":["string","null"],"description":"PubMed Central identifier (e.g., PMC1234567) — identifies the full-text version archived in the PMC open-access repository. Not all PubMed articles have a PMCID."},"doi":{"type":["string","null"],"description":"Digital Object Identifier — a persistent, publisher-assigned identifier that resolves via https://doi.org/{doi}."},"title":{"type":["string","null"]},"abstract":{"type":["string","null"]},"authors":{"type":"array","items":{"type":"string"}},"journal":{"type":["string","null"]},"issn":{"type":["string","null"]},"volumeIssue":{"type":["string","null"],"description":"Combined volume and issue number (e.g., \"23(4)\" for volume 23 issue 4, or \"23\" when only volume is available)."},"language":{"type":["string","null"],"description":"Three-letter ISO 639-2 language code of the article text (e.g., \"eng\", \"deu\", \"fra\")."},"publicationDate":{"type":["string","null"],"description":"Publication date in ISO 8601 format (YYYY-MM-DD). Day and month default to 01 when not available in the source record."},"publicationTypes":{"type":"array","items":{"type":"string"},"description":"MeSH publication types categorize the nature of the article (e.g., Clinical Trial, Review, Meta-Analysis). See the full list: [https://www.nlm.nih.gov/mesh/pubtypes.html](https://www.nlm.nih.gov/mesh/pubtypes.html)"},"isRetracted":{"type":["boolean","null"],"description":"Whether the article has been retracted, based on PubMed retraction notices."},"citationCount":{"type":["number","null"]},"journalQualityJufo":{"type":"number","minimum":0,"maximum":3,"description":"Publication Forum (Julkaisufoorumi - JuFo) is an openly published classification of publication channels created by the Finnish scientific community to support the quality assessment of academic research.\n  Each publication channel (academic journals, conferences and book publishers) is assigned a quality score which is evaluated on a regular basis and any changes are communicated publicly.\n  Each channel is assigned one of the following levels where meeting a higher level requires meeting the criteria for all lower levels, too:\n\n  - **No minimum**: Publication channels that have not been evaluated.\n  - **Low quality (JuFo Level 0)**: Publication channels that have been evaluated but do not meet all of the Level 1 criteria.\n  - **Peer reviewed (JuFo Level 1)**: includes peer-reviewed publication channels that are specialised in the publication of scientific research outcomes and have an editorial board of experts of the discipline. The majority of all publication channels are classified as Level 1 which is the basic level.\n  - **Domain leading (JuFo Level 2)**: The Levels 2 and 3 are awarded to a limited number of academic journals, conferences and book publishers of the highest level and impact as judged by the Expert Panels.\n  - **Highest quality (JuFo Level 3)**: The research published in Level 3 channels represents the highest level in the discipline and has extremely consistent impact (e.g., as measured through citation indicators).\n\n  Full explanation of the evaluation methodology behind JuFo:\n  [https://julkaisufoorumi.fi/en/evaluations/classification-criteria](https://julkaisufoorumi.fi/en/evaluations/classification-criteria)"},"meshTerms":{"type":"array","items":{"type":"string"},"description":"MeSH (Medical Subject Headings) descriptor names assigned to the article by NLM indexers (e.g., \"COVID-19\", \"Humans\"). Browse the MeSH vocabulary: [https://meshb.nlm.nih.gov/](https://meshb.nlm.nih.gov/)"},"keywords":{"type":"array","items":{"type":"string"}},"substances":{"type":"array","items":{"type":"string"},"description":"Chemical and drug substance names mentioned in the article, sourced from the NLM chemical registry (e.g., \"Aspirin\", \"Acetaminophen\")."},"hasFulltext":{"type":["boolean","null"]},"referencesTrialCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to TrialCore: Amass IDs of TrialCore records referenced by this publication, linking literature to their associated clinical trials."},"fulltext":{"type":["string","null"]},"authorsMetadata":{"type":"array","items":{"$ref":"#/components/schemas/AuthorMetadata"}},"substanceIds":{"type":"array","items":{"type":"string"},"description":"NLM substance registry unique identifiers corresponding to each entry in substances."},"meshIds":{"type":"array","items":{"type":"string"},"description":"MeSH unique identifiers corresponding to each entry in meshTerms (e.g., \"D000086382\"). Browse: [https://meshb.nlm.nih.gov/](https://meshb.nlm.nih.gov/)"},"references":{"type":"array","items":{"type":"string"},"description":"Intra-core link within BioMedCore: Amass IDs of other BioMedCore records (publications) referenced by this publication."},"citedBy":{"type":"array","items":{"type":"string"},"description":"Intra-core link within BioMedCore: Amass IDs of other BioMedCore records (publications) that cite this publication."}},"required":["amassId","pmcid","doi","title","abstract","authors","journal","issn","volumeIssue","language","publicationDate","publicationTypes","isRetracted","citationCount","journalQualityJufo","meshTerms","keywords","substances","hasFulltext"]},"AuthorMetadata":{"type":"object","properties":{"name":{"type":["string","null"]},"nameRaw":{"type":["string","null"]},"orcid":{"type":["string","null"]},"position":{"type":["number","null"]},"affiliations":{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"]},"nameRaw":{"type":["string","null"]},"ror":{"type":["string","null"]},"countryCode":{"type":["string","null"]}},"required":["name","nameRaw","ror","countryCode"]}}},"required":["name","nameRaw","orcid","position","affiliations"]},"Response_400":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"number","enum":[400],"example":400},"code":{"type":"string","enum":["BAD_REQUEST"],"example":"BAD_REQUEST"},"message":{"type":"string","example":"Bad Request"},"in":{"type":"string","example":"query"},"fields":{"type":"object","additionalProperties":{"type":"string"},"example":{"name":"Invalid name"}}},"required":["status","code","message"]}},"required":["error"]},"Response_401":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"number","enum":[401],"example":401},"code":{"type":"string","enum":["UNAUTHORIZED"],"example":"UNAUTHORIZED"},"message":{"type":"string","example":"Unauthorized"}},"required":["status","code","message"]}},"required":["error"]},"Response_403":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"number","enum":[403],"example":403},"code":{"type":"string","enum":["FORBIDDEN"],"example":"FORBIDDEN"},"message":{"type":"string","example":"Forbidden"}},"required":["status","code","message"]}},"required":["error"]},"Response_404":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"number","enum":[404],"example":404},"code":{"type":"string","enum":["NOT_FOUND"],"example":"NOT_FOUND"},"message":{"type":"string","example":"Not Found"}},"required":["status","code","message"]}},"required":["error"]},"Response_429":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"number","enum":[429],"example":429},"code":{"type":"string","enum":["TOO_MANY_REQUESTS"],"example":"TOO_MANY_REQUESTS"},"message":{"type":"string","example":"Too Many Requests"},"retryAfter":{"type":"number","example":10}},"required":["status","code","message","retryAfter"]}},"required":["error"]},"Response_500":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"number","enum":[500],"example":500},"code":{"type":"string","enum":["INTERNAL_SERVER_ERROR"],"example":"INTERNAL_SERVER_ERROR"},"message":{"type":"string","example":"Internal Server Error"}},"required":["status","code","message"]}},"required":["error"]},"TrialCoreRecord":{"type":"object","properties":{"amassId":{"type":"string"},"nctId":{"type":["string","null"],"description":"ClinicalTrials.gov identifier (e.g., NCT01234567) — a unique ID assigned to each study registered on [ClinicalTrials.gov](https://clinicaltrials.gov/)."},"briefTitle":{"type":["string","null"]},"officialTitle":{"type":["string","null"]},"briefSummary":{"type":["string","null"]},"acronym":{"type":["string","null"],"description":"Short study acronym or nickname, if assigned (e.g., \"KEYNOTE-189\", \"PACIFIC\")."},"phase":{"type":["string","null"],"enum":["EARLY_PHASE1","PHASE1","PHASE1/PHASE2","PHASE2","PHASE2/PHASE3","PHASE3","PHASE4","NA",null],"description":"Clinical trial phase indicating the stage of research. See: [https://clinicaltrials.gov/study-basics/glossary#phase](https://clinicaltrials.gov/study-basics/glossary#phase)"},"overallStatus":{"type":["string","null"],"enum":["RECRUITING","NOT_YET_RECRUITING","ENROLLING_BY_INVITATION","ACTIVE_NOT_RECRUITING","SUSPENDED","TERMINATED","COMPLETED","WITHDRAWN","UNKNOWN","WITHHELD","AVAILABLE","NO_LONGER_AVAILABLE","TEMPORARILY_NOT_AVAILABLE","APPROVED_FOR_MARKETING",null],"description":"Current recruitment or access status of the study. See: [https://clinicaltrials.gov/study-basics/glossary#recruitment-status](https://clinicaltrials.gov/study-basics/glossary#recruitment-status)"},"studyType":{"type":["string","null"],"enum":["INTERVENTIONAL","OBSERVATIONAL","EXPANDED_ACCESS",null],"description":"The nature of the study: INTERVENTIONAL (tests treatments), OBSERVATIONAL (monitors outcomes without intervention), or EXPANDED_ACCESS (provides access outside of trials)."},"startDate":{"type":["string","null"],"format":"date","description":"Date the study began enrolling participants.","example":"2020-01-01"},"completionDate":{"type":["string","null"],"format":"date","description":"Date the final participant completed the study (or estimated completion).","example":"2026-01-01"},"lastUpdateDate":{"type":["string","null"],"format":"date","description":"Date the study record was last updated on ClinicalTrials.gov.","example":"2026-01-01"},"hasResults":{"type":"boolean","description":"Whether the study has posted results on ClinicalTrials.gov."},"enrollment":{"type":["number","null"],"description":"Number of participants enrolled (or target enrollment). See enrollmentType to determine if this is actual or estimated."},"enrollmentType":{"type":["string","null"],"enum":["ACTUAL","ESTIMATED",null],"description":"Whether the enrollment count is ACTUAL (final) or ESTIMATED (target)."},"sponsorName":{"type":["string","null"]},"sponsorType":{"type":["string","null"],"enum":["NIH","FED","INDUSTRY","OTHER","OTHER_GOV","INDIV","NETWORK",null],"description":"Category of the lead sponsor: NIH, FED (other US federal agency), INDUSTRY, OTHER (e.g., university), OTHER_GOV (non-US government), INDIV (individual), or NETWORK."},"collaborators":{"type":"array","items":{"type":"string"}},"conditions":{"type":"array","items":{"type":"string"},"description":"Diseases or conditions studied in the trial, as specified by the sponsor."},"conditionMeshTerms":{"type":"array","items":{"type":"string"},"description":"MeSH terms mapped to the study conditions by ClinicalTrials.gov. Browse: [https://meshb.nlm.nih.gov/](https://meshb.nlm.nih.gov/)"},"interventionTypes":{"type":"array","items":{"type":"string","enum":["DRUG","DEVICE","BIOLOGICAL","COMBINATION_PRODUCT","PROCEDURE","RADIATION","DIETARY_SUPPLEMENT","GENETIC","BEHAVIORAL","DIAGNOSTIC_TEST","OTHER"]},"description":"Categories of interventions used in the trial (e.g., DRUG, DEVICE, BIOLOGICAL, PROCEDURE)."},"interventionNames":{"type":"array","items":{"type":"string"},"description":"Names of the specific interventions (e.g., drug names, device names)."},"interventionMeshTerms":{"type":"array","items":{"type":"string"},"description":"MeSH terms mapped to the study interventions by ClinicalTrials.gov. Browse: [https://meshb.nlm.nih.gov/](https://meshb.nlm.nih.gov/)"},"facilityCountries":{"type":"array","items":{"type":"string"},"description":"Countries where study facilities are located, as ISO 3166-1 alpha-2 codes (e.g., \"US\", \"DK\", \"DE\")."},"keywords":{"type":"array","items":{"type":"string"}},"orgStudyId":{"type":["string","null"],"description":"Unique protocol identifier assigned by the study sponsor (not the NCT ID)."},"secondaryIds":{"type":"array","items":{"type":"string"},"description":"Additional identifiers for the study (e.g., grant numbers, EudraCT numbers, other registry IDs)."},"primaryOutcomeMeasures":{"type":"array","items":{"type":"string"},"description":"Primary endpoints — the main results measured to determine whether the intervention worked."},"secondaryOutcomeMeasures":{"type":"array","items":{"type":"string"},"description":"Secondary endpoints — additional results measured to evaluate other effects of the intervention."},"designAllocation":{"type":["string","null"],"enum":["RANDOMIZED","NON_RANDOMIZED","NA",null],"description":"How participants are assigned to arms: RANDOMIZED, NON_RANDOMIZED, or NA (single-arm)."},"designInterventionModel":{"type":["string","null"],"enum":["SINGLE_GROUP","PARALLEL","CROSSOVER","FACTORIAL","SEQUENTIAL",null],"description":"Study design model describing how participants receive interventions: SINGLE_GROUP, PARALLEL (simultaneous arms), CROSSOVER (participants switch arms), FACTORIAL, or SEQUENTIAL."},"designPrimaryPurpose":{"type":["string","null"],"enum":["TREATMENT","PREVENTION","DIAGNOSTIC","ECT","SUPPORTIVE_CARE","SCREENING","HEALTH_SERVICES_RESEARCH","BASIC_SCIENCE","DEVICE_FEASIBILITY","OTHER",null],"description":"The main objective of the intervention (e.g., TREATMENT, PREVENTION, DIAGNOSTIC)."},"designMasking":{"type":["string","null"],"enum":["NONE","SINGLE","DOUBLE","TRIPLE","QUADRUPLE",null],"description":"Level of blinding: NONE (open-label), SINGLE (one party blinded), DOUBLE, TRIPLE, or QUADRUPLE (participant, care provider, investigator, and outcomes assessor all blinded)."},"resultsFirstPostDate":{"type":["string","null"],"format":"date","description":"Date results were first posted on ClinicalTrials.gov.","example":"2026-01-01"},"whyStopped":{"type":["string","null"],"description":"Reason the study was stopped early, if applicable (e.g., safety concerns, futility, enrollment issues)."},"isFdaRegulatedDrug":{"type":["boolean","null"],"description":"Whether the study involves a drug product regulated by the US FDA."},"isFdaRegulatedDevice":{"type":["boolean","null"],"description":"Whether the study involves a device product regulated by the US FDA."},"armGroups":{"type":"array","items":{"$ref":"#/components/schemas/TrialCoreArmGroup"},"description":"Study arms or groups — each arm describes a set of participants receiving a specific intervention or comparator."},"oversightHasDmc":{"type":["boolean","null"],"description":"Whether the study has an independent Data Monitoring Committee (DMC) overseeing participant safety."},"detailedDescription":{"type":["string","null"]},"referencesBiomedCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to BioMedCore: Amass IDs of BioMedCore records (publications) referenced by this trial, linking trials to their associated literature."},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/TrialCoreOutcome"},"description":"Posted trial results including outcome measurements, statistical parameters, and per-arm data."}},"required":["amassId","nctId","briefTitle","officialTitle","briefSummary","acronym","phase","overallStatus","studyType","startDate","completionDate","lastUpdateDate","hasResults","enrollment","enrollmentType","sponsorName","sponsorType","collaborators","conditions","conditionMeshTerms","interventionTypes","interventionNames","interventionMeshTerms","facilityCountries","keywords","orgStudyId","secondaryIds","primaryOutcomeMeasures","secondaryOutcomeMeasures","designAllocation","designInterventionModel","designPrimaryPurpose","designMasking","resultsFirstPostDate","whyStopped","isFdaRegulatedDrug","isFdaRegulatedDevice","armGroups","oversightHasDmc"]},"TrialCoreArmGroup":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["EXPERIMENTAL","ACTIVE_COMPARATOR","PLACEBO_COMPARATOR","SHAM_COMPARATOR","NO_INTERVENTION","OTHER",null],"description":"Role of this arm in the study (e.g., EXPERIMENTAL, PLACEBO_COMPARATOR, ACTIVE_COMPARATOR, NO_INTERVENTION)."},"title":{"type":["string","null"],"description":"Label for this arm (e.g., \"Drug A 10mg\", \"Placebo\")."},"description":{"type":["string","null"],"description":"Brief description of the intervention or comparator used in this arm."}},"required":["type","title","description"]},"TrialCoreOutcome":{"type":"object","properties":{"outcomeType":{"type":["string","null"],"enum":["PRIMARY","SECONDARY","OTHER_PRE_SPECIFIED","POST_HOC",null],"description":"Whether this is a PRIMARY, SECONDARY, OTHER_PRE_SPECIFIED, or POST_HOC outcome."},"title":{"type":["string","null"],"description":"Name of the outcome measure (e.g., \"Overall Survival\", \"Change in HbA1c\")."},"description":{"type":["string","null"],"description":"Detailed definition of how the outcome was measured."},"timeFrame":{"type":["string","null"],"description":"Time period over which the outcome was assessed (e.g., \"Baseline to 12 weeks\")."},"population":{"type":["string","null"],"description":"Description of the analysis population (e.g., \"Intent-to-treat\", \"Per-protocol\")."},"units":{"type":["string","null"],"description":"Unit of measurement for the reported values (e.g., \"Participants\", \"mg/dL\", \"Percentage of Participants\")."},"paramType":{"type":["string","null"],"enum":["GEOMETRIC_MEAN","GEOMETRIC_LEAST_SQUARES_MEAN","LEAST_SQUARES_MEAN","LOG_MEAN","MEAN","MEDIAN","NUMBER","COUNT_OF_PARTICIPANTS","COUNT_OF_UNITS",null],"description":"Statistical parameter type used for paramValue in measurements (e.g., MEAN, MEDIAN, COUNT_OF_PARTICIPANTS)."},"dispersionType":{"type":["string","null"],"enum":["NA","STANDARD_DEVIATION","STANDARD_ERROR","INTER_QUARTILE_RANGE","FULL_RANGE","CONFIDENCE_80","CONFIDENCE_90","CONFIDENCE_95","CONFIDENCE_975","CONFIDENCE_99","CONFIDENCE_OTHER","GEOMETRIC_COEFFICIENT",null],"description":"Type of variability measure used for dispersion values in measurements (e.g., STANDARD_DEVIATION, CONFIDENCE_95, FULL_RANGE)."},"measurements":{"type":"array","items":{"$ref":"#/components/schemas/TrialCoreOutcomeMeasurement"},"description":"Per-arm measurement data for this outcome."}},"required":["outcomeType","title","description","timeFrame","population","units","paramType","dispersionType","measurements"]},"TrialCoreOutcomeMeasurement":{"type":"object","properties":{"group":{"type":["string","null"],"description":"Display name of the arm or group this measurement belongs to."},"groupId":{"type":["string","null"],"description":"ClinicalTrials.gov internal group identifier (e.g., OG000)."},"classification":{"type":["string","null"],"description":"Row-level classification when results are broken down by subgroup (e.g., age range, body site)."},"category":{"type":["string","null"],"description":"Sub-category within a classification (e.g., a specific age bracket)."},"paramValue":{"type":["string","null"],"description":"The measured value for this outcome (interpretation depends on the parent outcome's paramType)."},"dispersionValue":{"type":["string","null"],"description":"Dispersion or variability value (interpretation depends on the parent outcome's dispersionType)."},"dispersionLowerLimit":{"type":["string","null"],"description":"Lower bound of the dispersion range (e.g., lower end of a confidence interval)."},"dispersionUpperLimit":{"type":["string","null"],"description":"Upper bound of the dispersion range (e.g., upper end of a confidence interval)."}}},"Citation":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["PAPER"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"journal":{"type":["string","null"]},"journal_quality":{"type":["number","null"]},"doi":{"type":["string","null"]},"pmid":{"type":["number","null"]},"publication_year":{"type":["string","null"]},"citation_count":{"type":["number","null"]}},"required":["id","type","title","authors"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["PATENT"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"title":{"type":"string"},"publication_number":{"type":["string","null"]},"inventors":{"type":"array","items":{"type":"string"}},"applicants":{"type":"array","items":{"type":"string"}},"assignee":{"type":["string","null"]},"filing_date":{"type":["string","null"]},"grant_date":{"type":["string","null"]},"publication_date":{"type":["string","null"]},"priority_date":{"type":["string","null"]},"jurisdiction":{"type":["string","null"]},"family_id":{"type":["string","null"]},"cited_by_count":{"type":["number","null"]}},"required":["id","type","title","inventors","applicants"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["TRIAL"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"title":{"type":"string"},"trial_id":{"type":"string"},"phase":{"type":["string","null"]},"status":{"type":["string","null"]},"conditions":{"type":"array","items":{"type":"string"}},"interventions":{"type":"array","items":{"type":"string"}},"sponsor":{"type":["string","null"]},"start_date":{"type":["string","null"]},"completion_date":{"type":["string","null"]}},"required":["id","type","title","trial_id","conditions","interventions"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["WEBPAGE"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"title":{"type":"string"},"site_name":{"type":["string","null"]},"author":{"type":["string","null"]},"published_date":{"type":["string","null"]}},"required":["id","type","title"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["DOCUMENT"]},"url":{"type":["string","null"]},"content":{"type":["string","null"]},"name":{"type":"string"},"document_type":{"type":["string","null"]},"author":{"type":["string","null"]},"date":{"type":["string","null"]}},"required":["id","type","name"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["CLOUD_FILE"]},"url":{"type":["string","null"]},"content":{"type":["string","null"]},"name":{"type":"string"},"document_type":{"type":["string","null"]},"author":{"type":["string","null"]},"date":{"type":["string","null"]}},"required":["id","type","name"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["TASK"]},"url":{"type":["string","null"]},"content":{"type":["string","null"]},"name":{"type":"string"},"document_type":{"type":["string","null"]},"author":{"type":["string","null"]},"date":{"type":["string","null"]}},"required":["id","type","name"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["ASSET"]},"url":{"type":["string","null"]},"content":{"type":["string","null"]},"name":{"type":"string"},"document_type":{"type":["string","null"]},"author":{"type":["string","null"]},"date":{"type":["string","null"]}},"required":["id","type","name"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["COMPANY"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"company_name":{"type":"string"},"status":{"type":["string","null"]},"development_stage":{"type":["string","null"]},"therapeutic_area":{"type":["string","null"]},"moa":{"type":["string","null"]},"modality":{"type":["string","null"]},"target_indications":{"type":["string","null"]},"location_country":{"type":["string","null"]},"date_added":{"type":["string","null"]}},"required":["id","type","company_name"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["REGULATORY_DRUG"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"medicine":{"type":"string"},"active_substance":{"type":["string","null"]},"marketing_authorisation_date":{"type":["string","null"]},"review_type":{"type":["string","null"]},"section_title":{"type":["string","null"]},"medicine_status":{"type":["string","null"]},"company_holder":{"type":["string","null"]},"author":{"type":["string","null"]}},"required":["id","type","medicine"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["MESSAGE"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"role":{"type":"string"},"message_index":{"type":"number"}},"required":["id","type","role","message_index"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["GENERIC"]},"url":{"type":["string","null"],"description":"The URL of the citation"},"content":{"type":["string","null"]},"metadata":{"type":["string","null"]},"title":{"type":["string","null"]}},"required":["id","type"]}]}},"parameters":{}},"paths":{"/api/v1/cores/biomedcore/records":{"get":{"operationId":"searchBiomedCoreRecords","tags":["cores/biomedcore"],"summary":"Search","description":"Search BiomedCore records. The system interprets your query and optimizes retrieval for best results — any filters you set explicitly always take priority.","parameters":[{"schema":{"type":"string"},"required":true,"name":"query","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":300,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["fulltext","authorsMetadata","meshIds","substanceIds","referencesTrialCore","references","citedBy"]}},"required":false,"name":"include","in":"query","style":"form","explode":true},{"schema":{"type":"string","format":"date","example":"2020-01-01"},"required":false,"name":"minPublicationDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-01-01"},"required":false,"name":"maxPublicationDate","in":"query"},{"schema":{"type":"number","minimum":0,"maximum":100000},"required":false,"name":"minCitationCount","in":"query"},{"schema":{"type":"number","minimum":0,"maximum":3,"description":"Publication Forum (Julkaisufoorumi - JuFo) is an openly published classification of publication channels created by the Finnish scientific community to support the quality assessment of academic research.\n  Each publication channel (academic journals, conferences and book publishers) is assigned a quality score which is evaluated on a regular basis and any changes are communicated publicly.\n  Each channel is assigned one of the following levels where meeting a higher level requires meeting the criteria for all lower levels, too:\n\n  - **No minimum**: Publication channels that have not been evaluated.\n  - **Low quality (JuFo Level 0)**: Publication channels that have been evaluated but do not meet all of the Level 1 criteria.\n  - **Peer reviewed (JuFo Level 1)**: includes peer-reviewed publication channels that are specialised in the publication of scientific research outcomes and have an editorial board of experts of the discipline. The majority of all publication channels are classified as Level 1 which is the basic level.\n  - **Domain leading (JuFo Level 2)**: The Levels 2 and 3 are awarded to a limited number of academic journals, conferences and book publishers of the highest level and impact as judged by the Expert Panels.\n  - **Highest quality (JuFo Level 3)**: The research published in Level 3 channels represents the highest level in the discipline and has extremely consistent impact (e.g., as measured through citation indicators).\n\n  Full explanation of the evaluation methodology behind JuFo:\n  [https://julkaisufoorumi.fi/en/evaluations/classification-criteria](https://julkaisufoorumi.fi/en/evaluations/classification-criteria)"},"required":false,"description":"Publication Forum (Julkaisufoorumi - JuFo) is an openly published classification of publication channels created by the Finnish scientific community to support the quality assessment of academic research.\n  Each publication channel (academic journals, conferences and book publishers) is assigned a quality score which is evaluated on a regular basis and any changes are communicated publicly.\n  Each channel is assigned one of the following levels where meeting a higher level requires meeting the criteria for all lower levels, too:\n\n  - **No minimum**: Publication channels that have not been evaluated.\n  - **Low quality (JuFo Level 0)**: Publication channels that have been evaluated but do not meet all of the Level 1 criteria.\n  - **Peer reviewed (JuFo Level 1)**: includes peer-reviewed publication channels that are specialised in the publication of scientific research outcomes and have an editorial board of experts of the discipline. The majority of all publication channels are classified as Level 1 which is the basic level.\n  - **Domain leading (JuFo Level 2)**: The Levels 2 and 3 are awarded to a limited number of academic journals, conferences and book publishers of the highest level and impact as judged by the Expert Panels.\n  - **Highest quality (JuFo Level 3)**: The research published in Level 3 channels represents the highest level in the discipline and has extremely consistent impact (e.g., as measured through citation indicators).\n\n  Full explanation of the evaluation methodology behind JuFo:\n  [https://julkaisufoorumi.fi/en/evaluations/classification-criteria](https://julkaisufoorumi.fi/en/evaluations/classification-criteria)","name":"minJournalQualityJufo","in":"query"},{"schema":{"type":"string","enum":["true","false"],"example":"true"},"required":false,"name":"isRetracted","in":"query"},{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BiomedCoreRecord"}}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_400"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_403"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_404"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_429"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_500"}}}}}}},"/api/v1/cores/biomedcore/records/{amassId}":{"get":{"operationId":"getBiomedCoreRecordByAmassId","tags":["cores/biomedcore"],"summary":"Get by Amass ID","description":"Get BiomedCore record by Amass ID","parameters":[{"schema":{"type":"string"},"required":true,"name":"amassId","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["fulltext","authorsMetadata","meshIds","substanceIds","referencesTrialCore","references","citedBy"]}},"required":false,"name":"include","in":"query","style":"form","explode":true},{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BiomedCoreRecord"}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_400"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_403"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_404"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_429"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_500"}}}}}}},"/api/v1/cores/biomedcore/records/lookup":{"post":{"operationId":"lookupBiomedCoreRecordsByPmidOrDoi","tags":["cores/biomedcore"],"summary":"Lookup Amass ID","description":"Lookup Amass ID by PMID or DOI","parameters":[{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"pmid":{"type":"string"}},"required":["pmid"],"additionalProperties":false},{"type":"object","properties":{"doi":{"type":"string"}},"required":["doi"],"additionalProperties":false}]}}},"required":["items"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"pmid":{"type":"string"}},"required":["pmid"],"additionalProperties":false},{"type":"object","properties":{"doi":{"type":"string"}},"required":["doi"],"additionalProperties":false}]},"amassIds":{"type":"array","items":{"type":"string","example":"AMBC_..."}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["input"]}}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_400"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_403"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_404"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_429"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_500"}}}}}}},"/api/v1/cores/trialcore/records":{"get":{"operationId":"searchTrialCoreRecords","tags":["cores/trialcore"],"summary":"Search","description":"Search TrialCore records. The system interprets your query and optimizes retrieval for best results — any filters you set explicitly always take priority.","parameters":[{"schema":{"type":"string"},"required":true,"name":"query","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":300,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["EARLY_PHASE1","PHASE1","PHASE1/PHASE2","PHASE2","PHASE2/PHASE3","PHASE3","PHASE4","NA"]},"required":false,"name":"phase","in":"query"},{"schema":{"type":"string","enum":["RECRUITING","NOT_YET_RECRUITING","ENROLLING_BY_INVITATION","ACTIVE_NOT_RECRUITING","SUSPENDED","TERMINATED","COMPLETED","WITHDRAWN","UNKNOWN","WITHHELD","AVAILABLE","NO_LONGER_AVAILABLE","TEMPORARILY_NOT_AVAILABLE","APPROVED_FOR_MARKETING"]},"required":false,"name":"overallStatus","in":"query"},{"schema":{"type":"string","enum":["INTERVENTIONAL","OBSERVATIONAL","EXPANDED_ACCESS"]},"required":false,"name":"studyType","in":"query"},{"schema":{"type":"string","enum":["NIH","FED","INDUSTRY","OTHER","OTHER_GOV","INDIV","NETWORK"]},"required":false,"name":"sponsorType","in":"query"},{"schema":{"type":"string","enum":["DRUG","DEVICE","BIOLOGICAL","COMBINATION_PRODUCT","PROCEDURE","RADIATION","DIETARY_SUPPLEMENT","GENETIC","BEHAVIORAL","DIAGNOSTIC_TEST","OTHER"]},"required":false,"name":"interventionType","in":"query"},{"schema":{"type":"string","example":"DE,US"},"required":false,"name":"facilityCountries","in":"query"},{"schema":{"type":"string","enum":["true","false"],"example":"true"},"required":false,"name":"hasResults","in":"query"},{"schema":{"type":"string","format":"date","example":"2020-01-01"},"required":false,"name":"minStartDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-01-01"},"required":false,"name":"maxStartDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-01-01"},"required":false,"name":"minCompletionDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-01-01"},"required":false,"name":"maxCompletionDate","in":"query"},{"schema":{"type":"number","example":10,"minimum":0},"required":false,"name":"minEnrollment","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["detailedDescription","outcomes","referencesBiomedCore"]}},"required":false,"name":"include","in":"query","style":"form","explode":true},{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TrialCoreRecord"}}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_400"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_403"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_404"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_429"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_500"}}}}}}},"/api/v1/cores/trialcore/records/{amassId}":{"get":{"operationId":"getTrialCoreRecordByAmassId","tags":["cores/trialcore"],"summary":"Get by Amass ID","description":"Get TrialCore record by Amass ID","parameters":[{"schema":{"type":"string"},"required":true,"name":"amassId","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["detailedDescription","outcomes","referencesBiomedCore"]}},"required":false,"name":"include","in":"query","style":"form","explode":true},{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TrialCoreRecord"}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_400"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_403"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_404"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_429"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_500"}}}}}}},"/api/v1/cores/trialcore/records/lookup":{"post":{"operationId":"lookupTrialCoreRecordsByNctId","tags":["cores/trialcore"],"summary":"Lookup","description":"Lookup TrialCore records by NctId","parameters":[{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"nctId":{"type":"string"}},"required":["nctId"],"additionalProperties":false}]}}},"required":["items"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"nctId":{"type":"string"}},"required":["nctId"],"additionalProperties":false}]},"amassIds":{"type":"array","items":{"type":"string","example":"AMTC_..."}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["input"]}}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_400"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_401"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_403"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_404"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_429"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response_500"}}}}}}}},"webhooks":{}}