{"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, clinical trials, and FDA & EMA drug regulatory authorizations.\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/getting-started/overview)\n- [Quickstart](https://platform.amass.tech/documentation/getting-started/quickstart)\n- [LLM Quick Reference](https://platform.amass.tech/documentation/getting-started/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":"array","items":{"type":"string"}},"required":false,"name":"authorOrcids","in":"query","style":"form","explode":true,"description":"Match ANY of these ORCIDs. Returns papers with at least one author whose ORCID is in the list. Accepts bare (`0000-0003-1234-5678`) or URL form (`https://orcid.org/0000-0003-1234-5678`). Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string"}},"required":false,"name":"authorNames","in":"query","style":"form","explode":true,"description":"Match ANY of these author names. Free-text token match, no prefix expansion. Combine with `query` for context-disambiguated results. Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string"}},"required":false,"name":"institutionRors","in":"query","style":"form","explode":true,"description":"Match ANY of these RORs. Returns papers with at least one affiliation in the list. Accepts bare (`03vek6s52`) or URL form (`https://ror.org/03vek6s52`). Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string"}},"required":false,"name":"institutionNames","in":"query","style":"form","explode":true,"description":"Match ANY of these institution names. Free-text token match. Repeat the param for multiple values."},{"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 record","description":"Get BiomedCore record by Amass ID","parameters":[{"schema":{"type":"string","example":"AMBC_..."},"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","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":"array","items":{"type":"string","enum":["EARLY_PHASE1","PHASE1","PHASE1/PHASE2","PHASE2","PHASE2/PHASE3","PHASE3","PHASE4","NA"]}},"required":false,"name":"phase","in":"query","style":"form","explode":true,"description":"Match ANY of these phases. Repeat the param for multiple values (e.g. `phase=PHASE1&phase=PHASE2`)."},{"schema":{"type":"array","items":{"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","style":"form","explode":true,"description":"Match ANY of these statuses. Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string","enum":["INTERVENTIONAL","OBSERVATIONAL","EXPANDED_ACCESS"]}},"required":false,"name":"studyType","in":"query","style":"form","explode":true,"description":"Match ANY of these study types. Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string","enum":["NIH","FED","INDUSTRY","OTHER","OTHER_GOV","INDIV","NETWORK"]}},"required":false,"name":"sponsorType","in":"query","style":"form","explode":true,"description":"Match ANY of these sponsor types. Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string","enum":["DRUG","DEVICE","BIOLOGICAL","COMBINATION_PRODUCT","PROCEDURE","RADIATION","DIETARY_SUPPLEMENT","GENETIC","BEHAVIORAL","DIAGNOSTIC_TEST","OTHER"]}},"required":false,"name":"interventionType","in":"query","style":"form","explode":true,"description":"Match ANY of these intervention types. Repeat the param for multiple values."},{"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 record","description":"Get TrialCore record by Amass ID","parameters":[{"schema":{"type":"string","example":"AMTC_..."},"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"}}}}}}},"/api/v1/cores/regulatorycore/records":{"get":{"operationId":"searchRegulatoryCoreRecords","tags":["cores/regulatorycore"],"summary":"Search","description":"Search RegulatoryCore records. Cross-agency search across FDA and EMA regulatory authorizations.","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":["FDA","EMA"]}},"required":false,"name":"agency","in":"query","style":"form","explode":true,"description":"Match ANY of these agencies. Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string","enum":["SMALL_MOLECULE","ANTIBODY","PROTEIN","ENZYME","OLIGONUCLEOTIDE","GENE","CELL","ANTIBODY_DRUG_CONJUGATE","VACCINE_COMPONENT","VACCINE","OLIGOSACCHARIDE","UNKNOWN"]}},"required":false,"name":"moleculeType","in":"query","style":"form","explode":true,"description":"Match ANY of these molecule types. Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string","enum":["ACTIVE","APPROVED_NOT_MARKETED","CONDITIONAL","SUSPENDED","WITHDRAWN_VOLUNTARY","WITHDRAWN_FORCED","REVOKED","LAPSED_SUNSET","REFUSED","WITHDRAWN_DURING_REVIEW","EXPIRED","UNKNOWN"]}},"required":false,"name":"authorizationStatus","in":"query","style":"form","explode":true,"description":"Match ANY of these authorization statuses. Repeat the param for multiple values."},{"schema":{"type":"string","format":"date","example":"2020-01-01"},"required":false,"name":"minAuthorizationDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2026-01-01"},"required":false,"name":"maxAuthorizationDate","in":"query"},{"schema":{"type":["boolean","null"],"description":"Filter by orphan designation (FDA Orphan Drug / EMA Orphan Medicine)"},"required":false,"description":"Filter by orphan designation (FDA Orphan Drug / EMA Orphan Medicine)","name":"isOrphan","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["PRIORITY_REVIEW","BREAKTHROUGH_THERAPY","FAST_TRACK","RMAT","ACCELERATED_APPROVAL","ACCELERATED_ASSESSMENT","PRIME","CONDITIONAL_MA","EXCEPTIONAL_CIRCUMSTANCES"]}},"required":false,"name":"hasDesignation","in":"query","style":"form","explode":true,"description":"Match ANY of these designations (applies only to the agency that has each). Repeat the param for multiple values."},{"schema":{"type":"string","example":"AMRC_...","description":"Scope the full-text search to a single record's source documents. When set, returns just that record (or none) with its matching documentSections (each carrying a matchedText excerpt)."},"required":false,"description":"Scope the full-text search to a single record's source documents. When set, returns just that record (or none) with its matching documentSections (each carrying a matchedText excerpt).","name":"amassId","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["emaDetails","fdaDetails","referencesDrugCore"]}},"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":{"type":"object","properties":{"amassId":{"type":"string","example":"AMRC_..."},"agency":{"type":"string","enum":["FDA","EMA"],"description":"Regulatory agency: FDA or EMA"},"name":{"type":["string","null"],"description":"Primary product / brand name"},"activeSubstance":{"type":["string","null"],"description":"Full active substance"},"moleculeType":{"type":["string","null"],"enum":["SMALL_MOLECULE","ANTIBODY","PROTEIN","ENZYME","OLIGONUCLEOTIDE","GENE","CELL","ANTIBODY_DRUG_CONJUGATE","VACCINE_COMPONENT","VACCINE","OLIGOSACCHARIDE","UNKNOWN",null],"description":"Molecule type (projected from DrugCore): SMALL_MOLECULE, ANTIBODY, PROTEIN, ENZYME, OLIGONUCLEOTIDE, GENE, CELL, ANTIBODY_DRUG_CONJUGATE, VACCINE_COMPONENT, VACCINE, OLIGOSACCHARIDE, UNKNOWN"},"authorizationStatus":{"type":["string","null"],"enum":["ACTIVE","APPROVED_NOT_MARKETED","CONDITIONAL","SUSPENDED","WITHDRAWN_VOLUNTARY","WITHDRAWN_FORCED","REVOKED","LAPSED_SUNSET","REFUSED","WITHDRAWN_DURING_REVIEW","EXPIRED","UNKNOWN",null],"description":"Unified authorization status (FDA + EMA): ACTIVE, APPROVED_NOT_MARKETED, CONDITIONAL, SUSPENDED, WITHDRAWN_VOLUNTARY, WITHDRAWN_FORCED, REVOKED, LAPSED_SUNSET, REFUSED, WITHDRAWN_DURING_REVIEW, EXPIRED, UNKNOWN"},"procedureType":{"type":["string","null"],"enum":["NDA","BLA","ANDA","CENTRALISED_HUMAN","WITHDRAWAL_HUMAN","CENTRALISED_VETERINARY","WITHDRAWAL_VETERINARY","UNKNOWN",null],"description":"Authorization procedure type. FDA: NDA, BLA, ANDA, UNKNOWN. EMA: CENTRALISED_HUMAN, WITHDRAWAL_HUMAN, CENTRALISED_VETERINARY, WITHDRAWAL_VETERINARY, UNKNOWN"},"therapeuticIndication":{"type":["string","null"],"description":"Approved indication text"},"marketingAuthorisationHolder":{"type":["string","null"],"description":"Sponsor / Marketing Authorisation Holder"},"authorizationDate":{"type":["string","null"],"description":"ISO date of FDA approval or EMA MA grant"},"firstAuthorizationDate":{"type":["string","null"],"description":"First-ever authorization date"},"lastUpdateDate":{"type":["string","null"],"description":"Last regulatory update date"},"sourceUrl":{"type":["string","null"],"description":"Agency landing page URL"},"isOrphan":{"type":["boolean","null"],"description":"Orphan designation (exact cross-walk: FDA Orphan Drug / EMA Orphan Medicine)"},"designations":{"type":"array","items":{"type":"object","properties":{"axis":{"type":"string","enum":["REVIEW_ACCELERATION","DEVELOPMENT_SUPPORT","EARLY_ACCESS_BASIS"],"description":"Shared comparison axis: REVIEW_ACCELERATION, DEVELOPMENT_SUPPORT, EARLY_ACCESS_BASIS"},"type":{"type":"string","enum":["PRIORITY_REVIEW","BREAKTHROUGH_THERAPY","FAST_TRACK","RMAT","ACCELERATED_APPROVAL","ACCELERATED_ASSESSMENT","PRIME","CONDITIONAL_MA","EXCEPTIONAL_CIRCUMSTANCES"],"description":"Agency-native designation type"},"agency":{"type":"string","enum":["FDA","EMA"],"description":"Granting agency"},"nativeName":{"type":["string","null"],"description":"Agency-native program name"},"basis":{"type":["string","null"],"enum":["SURROGATE_ENDPOINT","INCOMPLETE_DATA","UNCONFIRMABLE_DATA",null],"description":"Evidentiary basis for EARLY_ACCESS_BASIS rows — preserves why FDA Accelerated Approval (SURROGATE_ENDPOINT) differs from EMA Conditional MA (INCOMPLETE_DATA) / Exceptional Circumstances (UNCONFIRMABLE_DATA)"},"indication":{"type":["string","null"],"description":"Indication granted (FDA Accelerated Approval only)"},"postMarketingObligation":{"type":["boolean","null"],"description":"Whether the designation carries a post-marketing obligation"}},"required":["axis","type","agency","nativeName","basis","indication","postMarketingObligation"]},"description":"Granted regulatory designations tagged onto shared comparison axes (review acceleration, development support, early-access basis) — FDA and EMA programs comparable without being equated"},"authorizationsByAgency":{"type":"array","items":{"type":"object","properties":{"amassId":{"type":"string","example":"AMRC_..."},"agency":{"type":"string","enum":["FDA","EMA"],"description":"Agency of the linked authorization"},"name":{"type":["string","null"],"description":"Product / brand name of the linked authorization"},"authorizationStatus":{"type":["string","null"],"enum":["ACTIVE","APPROVED_NOT_MARKETED","CONDITIONAL","SUSPENDED","WITHDRAWN_VOLUNTARY","WITHDRAWN_FORCED","REVOKED","LAPSED_SUNSET","REFUSED","WITHDRAWN_DURING_REVIEW","EXPIRED","UNKNOWN",null],"description":"Status of the linked authorization — readable status-divergence headline (e.g. active in US / withdrawn in EU)"}},"required":["amassId","agency","name","authorizationStatus"]},"description":"The same product's other-market authorizations (self excluded). Carries each one's status so the cross-market status-divergence headline is readable straight off the list. Always populated."},"referencesDrugCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to DrugCore: Amass IDs (AMDC_*) of active ingredients in this product. Included with ?include=referencesDrugCore."},"emaDetails":{"type":["object","null"],"properties":{"productNumber":{"type":["string","null"],"description":"EMA product number"},"category":{"type":["string","null"],"description":"EPAR category (human / veterinary)"},"opinionStatus":{"type":["string","null"],"description":"CHMP opinion status"},"isBiosimilar":{"type":["boolean","null"],"description":"Biosimilar product"},"isAdvancedTherapy":{"type":["boolean","null"],"description":"ATMP / advanced therapy"},"isGenericOrHybrid":{"type":["boolean","null"],"description":"Generic / hybrid application"},"additionalMonitoring":{"type":["boolean","null"],"description":"Additional monitoring (black triangle)"},"pharmacotherapeuticGroup":{"type":["string","null"],"description":"Pharmacotherapeutic group (human)"},"patientSafety":{"type":["string","null"],"description":"Patient safety flag"},"latestProcedure":{"type":["string","null"],"description":"Latest procedure affecting product information"},"revisionNumber":{"type":["number","null"],"description":"EPAR revision number"},"smpcUrl":{"type":["string","null"],"description":"Direct URL to the EMA SmPC PDF"},"smpcDate":{"type":["string","null"],"description":"SmPC revision date (ISO)"},"opinionAdoptedDate":{"type":["string","null"],"description":"CHMP opinion adopted date (ISO)"},"europeanCommissionDecisionDate":{"type":["string","null"],"description":"European Commission decision date (ISO)"},"withdrawalOfApplicationDate":{"type":["string","null"],"description":"Withdrawal of application date (ISO)"},"refusalOfMarketingAuthorisationDate":{"type":["string","null"],"description":"Refusal of marketing authorisation date (ISO)"},"withdrawalExpiryRevocationLapseDate":{"type":["string","null"],"description":"Withdrawal / expiry / revocation / lapse of marketing authorisation date (ISO)"},"firstPublishedDate":{"type":["string","null"],"description":"First published date (ISO)"}},"required":["productNumber","category","opinionStatus","isBiosimilar","isAdvancedTherapy","isGenericOrHybrid","additionalMonitoring","pharmacotherapeuticGroup","patientSafety","latestProcedure","revisionNumber","smpcUrl","smpcDate","opinionAdoptedDate","europeanCommissionDecisionDate","withdrawalOfApplicationDate","refusalOfMarketingAuthorisationDate","withdrawalExpiryRevocationLapseDate","firstPublishedDate"],"description":"EMA-specific fields. Included with ?include=emaDetails."},"fdaDetails":{"type":["object","null"],"properties":{"applicationNumber":{"type":["string","null"],"description":"NDA/BLA application number"},"prescriptionClass":{"type":["string","null"],"description":"Rx/OTC marketing status (e.g. Prescription, Over-the-Counter, Discontinued)"},"submissionClassCode":{"type":["string","null"],"description":"Original submission class code (e.g. TYPE 1, TYPE 5)"},"labelDate":{"type":["string","null"],"description":"Label revision date (ISO)"},"labelUrl":{"type":["string","null"],"description":"Direct URL to the FDA label PDF"},"ndc":{"type":"array","items":{"type":"string"},"description":"National Drug Code (NDC) identifiers"},"splSetId":{"type":"array","items":{"type":"string"},"description":"SPL Set IDs"},"withdrawalDate":{"type":["string","null"],"description":"Withdrawal date (ISO): Federal Register publication date, when known"},"withdrawalReason":{"type":["string","null"],"description":"Withdrawal reason text (Federal Register abstract or 21 CFR 216.24 entry)"},"withdrawalSourceUrl":{"type":["string","null"],"description":"Source URL for the withdrawal (Federal Register notice or eCFR 216.24)"}},"required":["applicationNumber","prescriptionClass","submissionClassCode","labelDate","labelUrl","ndc","splSetId","withdrawalDate","withdrawalReason","withdrawalSourceUrl"],"description":"FDA-specific fields. Included with ?include=fdaDetails."},"documentSections":{"type":"array","items":{"type":"object","properties":{"documentSectionId":{"type":"string","example":"AMRCDS_..."},"amassId":{"type":"string","example":"AMRC_..."},"docType":{"type":"string","enum":["FDA_LABEL","FDA_REVIEW","EMA_SMPC","EMA_EPAR"]},"path":{"type":["string","null"],"example":"5.1","description":"Addressable section leaf. Numbered/stable for FDA_LABEL & EMA_SMPC, opaque for FDA_REVIEW & EMA_EPAR."},"title":{"type":["string","null"]},"textType":{"type":["string","null"],"description":"Native section type (e.g. Medical_Review, SmPC) where available"},"sourceUrl":{"type":["string","null"],"description":"Direct URL to the source PDF"},"sourceDate":{"type":["string","null"],"description":"Source revision date (ISO)"},"matchedText":{"type":["string","null"],"description":"Highlighted excerpt that drove the match on search (GET /records?query=) — NOT the full section body. Follow documentSectionId via /records/{amassId}/document-sections/{documentSectionId} for full content."}},"required":["documentSectionId","amassId","docType","path","title","textType","sourceUrl","sourceDate","matchedText"]},"description":"On search (GET /records?query=): PDF-content evidence sections that drove the match, each with a matchedText excerpt (empty when the match was metadata-only). Each carries a documentSectionId fetchable via /records/{amassId}/document-sections/{documentSectionId}."}},"required":["amassId","agency","name","activeSubstance","moleculeType","authorizationStatus","procedureType","therapeuticIndication","marketingAuthorisationHolder","authorizationDate","firstAuthorizationDate","lastUpdateDate","sourceUrl","isOrphan","designations","authorizationsByAgency","documentSections"]}}},"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/regulatorycore/records/{amassId}":{"get":{"operationId":"getRegulatoryCoreRecordByAmassId","tags":["cores/regulatorycore"],"summary":"Get record","description":"Get RegulatoryCore record by Amass ID","parameters":[{"schema":{"type":"string","example":"AMRC_..."},"required":true,"name":"amassId","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["emaDetails","fdaDetails","referencesDrugCore"]}},"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":"object","properties":{"amassId":{"type":"string","example":"AMRC_..."},"agency":{"type":"string","enum":["FDA","EMA"],"description":"Regulatory agency: FDA or EMA"},"name":{"type":["string","null"],"description":"Primary product / brand name"},"activeSubstance":{"type":["string","null"],"description":"Full active substance"},"moleculeType":{"type":["string","null"],"enum":["SMALL_MOLECULE","ANTIBODY","PROTEIN","ENZYME","OLIGONUCLEOTIDE","GENE","CELL","ANTIBODY_DRUG_CONJUGATE","VACCINE_COMPONENT","VACCINE","OLIGOSACCHARIDE","UNKNOWN",null],"description":"Molecule type (projected from DrugCore): SMALL_MOLECULE, ANTIBODY, PROTEIN, ENZYME, OLIGONUCLEOTIDE, GENE, CELL, ANTIBODY_DRUG_CONJUGATE, VACCINE_COMPONENT, VACCINE, OLIGOSACCHARIDE, UNKNOWN"},"authorizationStatus":{"type":["string","null"],"enum":["ACTIVE","APPROVED_NOT_MARKETED","CONDITIONAL","SUSPENDED","WITHDRAWN_VOLUNTARY","WITHDRAWN_FORCED","REVOKED","LAPSED_SUNSET","REFUSED","WITHDRAWN_DURING_REVIEW","EXPIRED","UNKNOWN",null],"description":"Unified authorization status (FDA + EMA): ACTIVE, APPROVED_NOT_MARKETED, CONDITIONAL, SUSPENDED, WITHDRAWN_VOLUNTARY, WITHDRAWN_FORCED, REVOKED, LAPSED_SUNSET, REFUSED, WITHDRAWN_DURING_REVIEW, EXPIRED, UNKNOWN"},"procedureType":{"type":["string","null"],"enum":["NDA","BLA","ANDA","CENTRALISED_HUMAN","WITHDRAWAL_HUMAN","CENTRALISED_VETERINARY","WITHDRAWAL_VETERINARY","UNKNOWN",null],"description":"Authorization procedure type. FDA: NDA, BLA, ANDA, UNKNOWN. EMA: CENTRALISED_HUMAN, WITHDRAWAL_HUMAN, CENTRALISED_VETERINARY, WITHDRAWAL_VETERINARY, UNKNOWN"},"therapeuticIndication":{"type":["string","null"],"description":"Approved indication text"},"marketingAuthorisationHolder":{"type":["string","null"],"description":"Sponsor / Marketing Authorisation Holder"},"authorizationDate":{"type":["string","null"],"description":"ISO date of FDA approval or EMA MA grant"},"firstAuthorizationDate":{"type":["string","null"],"description":"First-ever authorization date"},"lastUpdateDate":{"type":["string","null"],"description":"Last regulatory update date"},"sourceUrl":{"type":["string","null"],"description":"Agency landing page URL"},"isOrphan":{"type":["boolean","null"],"description":"Orphan designation (exact cross-walk: FDA Orphan Drug / EMA Orphan Medicine)"},"designations":{"type":"array","items":{"type":"object","properties":{"axis":{"type":"string","enum":["REVIEW_ACCELERATION","DEVELOPMENT_SUPPORT","EARLY_ACCESS_BASIS"],"description":"Shared comparison axis: REVIEW_ACCELERATION, DEVELOPMENT_SUPPORT, EARLY_ACCESS_BASIS"},"type":{"type":"string","enum":["PRIORITY_REVIEW","BREAKTHROUGH_THERAPY","FAST_TRACK","RMAT","ACCELERATED_APPROVAL","ACCELERATED_ASSESSMENT","PRIME","CONDITIONAL_MA","EXCEPTIONAL_CIRCUMSTANCES"],"description":"Agency-native designation type"},"agency":{"type":"string","enum":["FDA","EMA"],"description":"Granting agency"},"nativeName":{"type":["string","null"],"description":"Agency-native program name"},"basis":{"type":["string","null"],"enum":["SURROGATE_ENDPOINT","INCOMPLETE_DATA","UNCONFIRMABLE_DATA",null],"description":"Evidentiary basis for EARLY_ACCESS_BASIS rows — preserves why FDA Accelerated Approval (SURROGATE_ENDPOINT) differs from EMA Conditional MA (INCOMPLETE_DATA) / Exceptional Circumstances (UNCONFIRMABLE_DATA)"},"indication":{"type":["string","null"],"description":"Indication granted (FDA Accelerated Approval only)"},"postMarketingObligation":{"type":["boolean","null"],"description":"Whether the designation carries a post-marketing obligation"}},"required":["axis","type","agency","nativeName","basis","indication","postMarketingObligation"]},"description":"Granted regulatory designations tagged onto shared comparison axes (review acceleration, development support, early-access basis) — FDA and EMA programs comparable without being equated"},"authorizationsByAgency":{"type":"array","items":{"type":"object","properties":{"amassId":{"type":"string","example":"AMRC_..."},"agency":{"type":"string","enum":["FDA","EMA"],"description":"Agency of the linked authorization"},"name":{"type":["string","null"],"description":"Product / brand name of the linked authorization"},"authorizationStatus":{"type":["string","null"],"enum":["ACTIVE","APPROVED_NOT_MARKETED","CONDITIONAL","SUSPENDED","WITHDRAWN_VOLUNTARY","WITHDRAWN_FORCED","REVOKED","LAPSED_SUNSET","REFUSED","WITHDRAWN_DURING_REVIEW","EXPIRED","UNKNOWN",null],"description":"Status of the linked authorization — readable status-divergence headline (e.g. active in US / withdrawn in EU)"}},"required":["amassId","agency","name","authorizationStatus"]},"description":"The same product's other-market authorizations (self excluded). Carries each one's status so the cross-market status-divergence headline is readable straight off the list. Always populated."},"referencesDrugCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to DrugCore: Amass IDs (AMDC_*) of active ingredients in this product. Included with ?include=referencesDrugCore."},"emaDetails":{"type":["object","null"],"properties":{"productNumber":{"type":["string","null"],"description":"EMA product number"},"category":{"type":["string","null"],"description":"EPAR category (human / veterinary)"},"opinionStatus":{"type":["string","null"],"description":"CHMP opinion status"},"isBiosimilar":{"type":["boolean","null"],"description":"Biosimilar product"},"isAdvancedTherapy":{"type":["boolean","null"],"description":"ATMP / advanced therapy"},"isGenericOrHybrid":{"type":["boolean","null"],"description":"Generic / hybrid application"},"additionalMonitoring":{"type":["boolean","null"],"description":"Additional monitoring (black triangle)"},"pharmacotherapeuticGroup":{"type":["string","null"],"description":"Pharmacotherapeutic group (human)"},"patientSafety":{"type":["string","null"],"description":"Patient safety flag"},"latestProcedure":{"type":["string","null"],"description":"Latest procedure affecting product information"},"revisionNumber":{"type":["number","null"],"description":"EPAR revision number"},"smpcUrl":{"type":["string","null"],"description":"Direct URL to the EMA SmPC PDF"},"smpcDate":{"type":["string","null"],"description":"SmPC revision date (ISO)"},"opinionAdoptedDate":{"type":["string","null"],"description":"CHMP opinion adopted date (ISO)"},"europeanCommissionDecisionDate":{"type":["string","null"],"description":"European Commission decision date (ISO)"},"withdrawalOfApplicationDate":{"type":["string","null"],"description":"Withdrawal of application date (ISO)"},"refusalOfMarketingAuthorisationDate":{"type":["string","null"],"description":"Refusal of marketing authorisation date (ISO)"},"withdrawalExpiryRevocationLapseDate":{"type":["string","null"],"description":"Withdrawal / expiry / revocation / lapse of marketing authorisation date (ISO)"},"firstPublishedDate":{"type":["string","null"],"description":"First published date (ISO)"}},"required":["productNumber","category","opinionStatus","isBiosimilar","isAdvancedTherapy","isGenericOrHybrid","additionalMonitoring","pharmacotherapeuticGroup","patientSafety","latestProcedure","revisionNumber","smpcUrl","smpcDate","opinionAdoptedDate","europeanCommissionDecisionDate","withdrawalOfApplicationDate","refusalOfMarketingAuthorisationDate","withdrawalExpiryRevocationLapseDate","firstPublishedDate"],"description":"EMA-specific fields. Included with ?include=emaDetails."},"fdaDetails":{"type":["object","null"],"properties":{"applicationNumber":{"type":["string","null"],"description":"NDA/BLA application number"},"prescriptionClass":{"type":["string","null"],"description":"Rx/OTC marketing status (e.g. Prescription, Over-the-Counter, Discontinued)"},"submissionClassCode":{"type":["string","null"],"description":"Original submission class code (e.g. TYPE 1, TYPE 5)"},"labelDate":{"type":["string","null"],"description":"Label revision date (ISO)"},"labelUrl":{"type":["string","null"],"description":"Direct URL to the FDA label PDF"},"ndc":{"type":"array","items":{"type":"string"},"description":"National Drug Code (NDC) identifiers"},"splSetId":{"type":"array","items":{"type":"string"},"description":"SPL Set IDs"},"withdrawalDate":{"type":["string","null"],"description":"Withdrawal date (ISO): Federal Register publication date, when known"},"withdrawalReason":{"type":["string","null"],"description":"Withdrawal reason text (Federal Register abstract or 21 CFR 216.24 entry)"},"withdrawalSourceUrl":{"type":["string","null"],"description":"Source URL for the withdrawal (Federal Register notice or eCFR 216.24)"}},"required":["applicationNumber","prescriptionClass","submissionClassCode","labelDate","labelUrl","ndc","splSetId","withdrawalDate","withdrawalReason","withdrawalSourceUrl"],"description":"FDA-specific fields. Included with ?include=fdaDetails."},"documentSections":{"type":"array","items":{"type":"object","properties":{"documentSectionId":{"type":"string","example":"AMRCDS_..."},"amassId":{"type":"string","example":"AMRC_..."},"docType":{"type":"string","enum":["FDA_LABEL","FDA_REVIEW","EMA_SMPC","EMA_EPAR"]},"path":{"type":["string","null"],"example":"5.1","description":"Addressable section leaf. Numbered/stable for FDA_LABEL & EMA_SMPC, opaque for FDA_REVIEW & EMA_EPAR."},"title":{"type":["string","null"]},"textType":{"type":["string","null"],"description":"Native section type (e.g. Medical_Review, SmPC) where available"},"sourceUrl":{"type":["string","null"],"description":"Direct URL to the source PDF"},"sourceDate":{"type":["string","null"],"description":"Source revision date (ISO)"}},"required":["documentSectionId","amassId","docType","path","title","textType","sourceUrl","sourceDate"]},"description":"The record's full table of contents: every parsed source-document section (FDA labels/reviews, EMA SmPCs/EPARs), structural only. No matchedText (that is search-only) and no content body — fetch a section's full content via /records/{amassId}/document-sections/{documentSectionId}."}},"required":["amassId","agency","name","activeSubstance","moleculeType","authorizationStatus","procedureType","therapeuticIndication","marketingAuthorisationHolder","authorizationDate","firstAuthorizationDate","lastUpdateDate","sourceUrl","isOrphan","designations","authorizationsByAgency","documentSections"]}},"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/regulatorycore/records/{amassId}/document-sections/{documentSectionId}":{"get":{"operationId":"getRegulatoryCoreDocumentSection","tags":["cores/regulatorycore"],"summary":"Get document section","description":"Fetch one parsed source-document section (FDA labels/reviews, EMA SmPCs/EPARs) by its AMRCDS_* id, with full content. Discover the id via the table of contents on GET /records/{amassId} or scoped search on GET /records?query=&amassId=. The full source PDF is at the section's sourceUrl.","parameters":[{"schema":{"type":"string","example":"AMRC_..."},"required":true,"name":"amassId","in":"path"},{"schema":{"type":"string","example":"AMRCDS_..."},"required":true,"name":"documentSectionId","in":"path"},{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"documentSectionId":{"type":"string","example":"AMRCDS_..."},"amassId":{"type":"string","example":"AMRC_..."},"docType":{"type":"string","enum":["FDA_LABEL","FDA_REVIEW","EMA_SMPC","EMA_EPAR"]},"path":{"type":["string","null"],"example":"5.1","description":"Addressable section leaf. Numbered/stable for FDA_LABEL & EMA_SMPC, opaque for FDA_REVIEW & EMA_EPAR."},"title":{"type":["string","null"]},"textType":{"type":["string","null"],"description":"Native section type (e.g. Medical_Review, SmPC) where available"},"sourceUrl":{"type":["string","null"],"description":"Direct URL to the source PDF"},"sourceDate":{"type":["string","null"],"description":"Source revision date (ISO)"},"content":{"type":["string","null"],"description":"Full parsed section text."}},"required":["documentSectionId","amassId","docType","path","title","textType","sourceUrl","sourceDate","content"]}},"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/regulatorycore/records/lookup":{"post":{"operationId":"lookupRegulatoryCoreRecords","tags":["cores/regulatorycore"],"summary":"Lookup","description":"Lookup Amass IDs by FDA application number, EMA product number, NDC, or SPL Set ID","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":{"fdaApplicationNumber":{"type":"string"}},"required":["fdaApplicationNumber"],"additionalProperties":false},{"type":"object","properties":{"emaProductNumber":{"type":"string"}},"required":["emaProductNumber"],"additionalProperties":false},{"type":"object","properties":{"ndc":{"type":"string"}},"required":["ndc"],"additionalProperties":false},{"type":"object","properties":{"splSetId":{"type":"string"}},"required":["splSetId"],"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":{"fdaApplicationNumber":{"type":"string"}},"required":["fdaApplicationNumber"],"additionalProperties":false},{"type":"object","properties":{"emaProductNumber":{"type":"string"}},"required":["emaProductNumber"],"additionalProperties":false},{"type":"object","properties":{"ndc":{"type":"string"}},"required":["ndc"],"additionalProperties":false},{"type":"object","properties":{"splSetId":{"type":"string"}},"required":["splSetId"],"additionalProperties":false}]},"amassIds":{"type":"array","items":{"type":"string","example":"AMRC_..."}},"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/drugcore/records":{"get":{"operationId":"searchDrugCoreRecords","tags":["cores/drugcore"],"summary":"Search","description":"Search DrugCore records. Keyword search across drug names, trade names, synonyms, and descriptions.","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":["SMALL_MOLECULE","ANTIBODY","PROTEIN","OLIGONUCLEOTIDE","GENE","ENZYME","ANTIBODY_DRUG_CONJUGATE","VACCINE_COMPONENT","CELL","OLIGOSACCHARIDE","VACCINE","UNKNOWN"]}},"required":false,"name":"drugType","in":"query","style":"form","explode":true,"description":"Match ANY of these drug modalities. Repeat the param for multiple values (e.g. `drugType=ANTIBODY&drugType=PROTEIN`)."},{"schema":{"type":"array","items":{"type":"string","enum":["EARLY_PHASE1","PHASE1","PHASE1/PHASE2","PHASE2","PHASE2/PHASE3","PHASE3","PRECLINICAL","IND","PREAPPROVAL","APPROVAL","UNKNOWN"]}},"required":false,"name":"maxClinicalStage","in":"query","style":"form","explode":true,"description":"Match ANY of these clinical stages. Repeat the param for multiple values."},{"schema":{"type":"array","items":{"type":"string","enum":["parent","children","referencesTrialCore","referencesBiomedCore","referencesRegulatoryCore"]}},"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":{"type":"object","properties":{"amassId":{"type":"string","example":"AMDC_..."},"chemblId":{"type":["string","null"],"description":"ChEMBL molecule identifier"},"name":{"type":["string","null"],"description":"Primary drug name"},"description":{"type":["string","null"],"description":"A short free-text description of the drug, its clinical stage, and/or its indications"},"synonyms":{"type":"array","items":{"type":"string"},"description":"Alternative names for the drug"},"tradeNames":{"type":"array","items":{"type":"string"},"description":"Brand / trade names"},"drugType":{"type":["string","null"],"description":"Drug modality: SMALL_MOLECULE, ANTIBODY, PROTEIN, OLIGONUCLEOTIDE, GENE, ENZYME, ANTIBODY_DRUG_CONJUGATE, VACCINE_COMPONENT, CELL, OLIGOSACCHARIDE, VACCINE, UNKNOWN"},"maxClinicalStage":{"type":["string","null"],"description":"Highest clinical stage reached: EARLY_PHASE1, PHASE1, PHASE1/PHASE2, PHASE2, PHASE2/PHASE3, PHASE3, PRECLINICAL, IND, PREAPPROVAL, APPROVAL, UNKNOWN"},"inchiKey":{"type":["string","null"],"description":"InChIKey structure hash"},"canonicalSmiles":{"type":["string","null"],"description":"Canonical SMILES string"},"parent":{"type":["string","null"],"description":"Parent drug Amass ID (AMDC_*). Included with ?include=parent."},"children":{"type":"array","items":{"type":"string"},"description":"Child drug Amass IDs (AMDC_*). Included with ?include=children."},"referencesTrialCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to TrialCore: Amass IDs of TrialCore records (clinical trials) associated with this drug, linking drugs to their clinical trials. Included with ?include=referencesTrialCore."},"referencesBiomedCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to BioMedCore: Amass IDs of BioMedCore records (publications) referenced by this drug, linking drugs to their associated literature. Included with ?include=referencesBiomedCore."},"referencesRegulatoryCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to RegulatoryCore: Amass IDs of RegulatoryCore records (FDA/EMA authorizations) associated with this drug, linking drugs to their regulatory approvals. Included with ?include=referencesRegulatoryCore."}},"required":["amassId","chemblId","name","description","synonyms","tradeNames","drugType","maxClinicalStage","inchiKey","canonicalSmiles"]}}},"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/drugcore/records/{amassId}":{"get":{"operationId":"getDrugCoreRecordByAmassId","tags":["cores/drugcore"],"summary":"Get record","description":"Get DrugCore record by Amass ID","parameters":[{"schema":{"type":"string","example":"AMDC_..."},"required":true,"name":"amassId","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["parent","children","referencesTrialCore","referencesBiomedCore","referencesRegulatoryCore"]}},"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":"object","properties":{"amassId":{"type":"string","example":"AMDC_..."},"chemblId":{"type":["string","null"],"description":"ChEMBL molecule identifier"},"name":{"type":["string","null"],"description":"Primary drug name"},"description":{"type":["string","null"],"description":"A short free-text description of the drug, its clinical stage, and/or its indications"},"synonyms":{"type":"array","items":{"type":"string"},"description":"Alternative names for the drug"},"tradeNames":{"type":"array","items":{"type":"string"},"description":"Brand / trade names"},"drugType":{"type":["string","null"],"description":"Drug modality: SMALL_MOLECULE, ANTIBODY, PROTEIN, OLIGONUCLEOTIDE, GENE, ENZYME, ANTIBODY_DRUG_CONJUGATE, VACCINE_COMPONENT, CELL, OLIGOSACCHARIDE, VACCINE, UNKNOWN"},"maxClinicalStage":{"type":["string","null"],"description":"Highest clinical stage reached: EARLY_PHASE1, PHASE1, PHASE1/PHASE2, PHASE2, PHASE2/PHASE3, PHASE3, PRECLINICAL, IND, PREAPPROVAL, APPROVAL, UNKNOWN"},"inchiKey":{"type":["string","null"],"description":"InChIKey structure hash"},"canonicalSmiles":{"type":["string","null"],"description":"Canonical SMILES string"},"parent":{"type":["string","null"],"description":"Parent drug Amass ID (AMDC_*). Included with ?include=parent."},"children":{"type":"array","items":{"type":"string"},"description":"Child drug Amass IDs (AMDC_*). Included with ?include=children."},"referencesTrialCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to TrialCore: Amass IDs of TrialCore records (clinical trials) associated with this drug, linking drugs to their clinical trials. Included with ?include=referencesTrialCore."},"referencesBiomedCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to BioMedCore: Amass IDs of BioMedCore records (publications) referenced by this drug, linking drugs to their associated literature. Included with ?include=referencesBiomedCore."},"referencesRegulatoryCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to RegulatoryCore: Amass IDs of RegulatoryCore records (FDA/EMA authorizations) associated with this drug, linking drugs to their regulatory approvals. Included with ?include=referencesRegulatoryCore."}},"required":["amassId","chemblId","name","description","synonyms","tradeNames","drugType","maxClinicalStage","inchiKey","canonicalSmiles"]}},"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/drugcore/records/lookup":{"post":{"operationId":"lookupDrugCoreRecords","tags":["cores/drugcore"],"summary":"Lookup","description":"Lookup Amass IDs by ChEMBL ID","parameters":[{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"chemblId":{"type":"string"}},"required":["chemblId"],"additionalProperties":false}}},"required":["items"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"input":{"type":"object","properties":{"chemblId":{"type":"string"}},"required":["chemblId"],"additionalProperties":false},"amassIds":{"type":"array","items":{"type":"string","example":"AMDC_..."}},"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/credits/api-credits":{"get":{"operationId":"getApiCredits","tags":["credits"],"summary":"Get API credits","description":"Get the number of API credits remaining for the authenticated organization.","parameters":[{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"remaining":{"type":"number"}},"required":["remaining"]}},"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":{}}