{"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."},"lastUpdateDate":{"type":["string","null"],"format":"date","description":"The date Amass last wrote this record. It moves on any ingested change — the PubMed citation itself, PMC fulltext arriving, a citation count refreshing, or cross-core links updating — not only the publication's own content. May be null for records written before Amass tracked it.","example":"2026-01-01"},"createDate":{"type":["string","null"],"format":"date","description":"Date this record first entered Amass — when it was ingested, not when it was published. This is the same value the change feed reports, so it is the field to compare a feed item against. May be null for records ingested before Amass tracked it.","example":"2026-01-01"},"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","lastUpdateDate","createDate","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"]},"BiomedCoreChangedRecord":{"type":"object","properties":{"amassId":{"type":"string","example":"AMBC_..."},"updateType":{"type":"string","enum":["created","updated","deleted"],"description":"`created` when this delivery is the record's first appearance in the feed, `deleted` if citation has been withdrown, `updated` otherwise. It describes the delivery, not the record: a publication that entered inside your window and then changed again appears as `updated`. To spot genuinely new publications, compare `createDate` against your window rather than branching on this. A record that predates create-date tracking reports `updated`. A retraction is an `updated` with `isRetracted: true`, not a `deleted`."},"updateDate":{"type":"string","format":"date","description":"The change that caused this delivery — always inside the requested window, and the value the feed pages on. For a deletion this is the date the removal was observed.","example":"2026-01-01"},"createDate":{"type":["string","null"],"format":"date","description":"Date this record first entered Amass, if known. Always null when updateType is `deleted`.","example":"2026-01-01"}},"required":["amassId","updateType","updateDate","createDate"]},"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/). Null for trials sourced from non-US registries (see registryId)."},"registryId":{"type":["string","null"],"description":"Identifier assigned by the trial's source registry. For ClinicalTrials.gov trials this equals nctId; for trials sourced from the WHO ICTRP it is the native registry ID (e.g., EUCTR2021-000123-45, ChiCTR2400012345, JPRN-jRCT2080224567). Unlike nctId, this is populated for every record."},"sourceRegistry":{"type":["string","null"],"description":"Slug identifying which registry the record was sourced from: `clinicaltrials_gov` for US trials, or a WHO ICTRP member-registry slug for non-US trials (e.g., `euctr`, `ctis`, `chictr`, `isrctn`, `anzctr`, `jprn`, `ctri`, `drks`)."},"sourceUrl":{"type":["string","null"],"description":"Link to the trial record on its source registry."},"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":"The date Amass last wrote this record. It moves on any ingested change, so it answers \"is what I hold current\" rather than \"did the trial's substance change\". Observed by Amass, not the registry's own claim. Not the same as the change feed's `updateDate`, which also covers posted-results revisions and removed outcome rows and can therefore be newer.","example":"2026-01-01"},"createDate":{"type":["string","null"],"format":"date","description":"Date this record first entered Amass. May be null for records ingested before Amass tracked it.","example":"2026-01-01"},"hasResults":{"type":"boolean","description":"Whether the study has posted results on its source registry."},"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, where available. 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, where available. 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 the study's source registry.","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. Ordered results-first. A paper whose own PubMed record registers this trial's id is reporting that trial, so it comes before the background literature the sponsor also filed."},"referencesDrugCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to DrugCore: Amass IDs of DrugCore records (drugs) studied by this trial, linking trials to the drugs they evaluate. Included with ?include=referencesDrugCore."},"outcomes":{"type":"array","items":{"$ref":"#/components/schemas/TrialCoreOutcome"},"description":"Posted trial results including outcome measurements, statistical parameters, and per-arm data."}},"required":["amassId","nctId","registryId","sourceRegistry","sourceUrl","briefTitle","officialTitle","briefSummary","acronym","phase","overallStatus","studyType","startDate","completionDate","lastUpdateDate","createDate","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)."}}},"TrialCoreChangedRecord":{"type":"object","properties":{"amassId":{"type":"string","example":"AMTC_..."},"updateType":{"type":"string","enum":["created","updated","deleted"],"description":"`created` when this delivery is the record's first appearance in the feed, `deleted` if it left its source registry, `updated` otherwise. It describes the delivery, not the record: a trial that entered inside your window and then changed again — its own record or its posted results — arrives once, as `updated`. To spot genuinely new trials, compare `createDate` against your window rather than branching on this. A record that predates create-date tracking reports `updated`."},"updateDate":{"type":"string","format":"date","description":"The change that caused this delivery — always inside the requested window, and the value the feed pages on. For a deletion this is the date the removal was observed. It can be newer than the record's own lastUpdateDate, which does not move when only the trial's posted results are revised.","example":"2026-01-01"},"createDate":{"type":["string","null"],"format":"date","description":"Date this record first entered Amass, if known. Always null when updateType is `deleted`.","example":"2026-01-01"}},"required":["amassId","updateType","updateDate","createDate"]},"GeneCoreLookupItem":{"anyOf":[{"type":"object","properties":{"ensemblGeneId":{"type":"string"}},"required":["ensemblGeneId"],"additionalProperties":false,"example":{"ensemblGeneId":"ENSG00000146648"}},{"type":"object","properties":{"hgncId":{"type":"string"}},"required":["hgncId"],"additionalProperties":false,"example":{"hgncId":"HGNC:3236"}},{"type":"object","properties":{"entrezGeneId":{"type":"string"}},"required":["entrezGeneId"],"additionalProperties":false,"example":{"entrezGeneId":"1956"}},{"type":"object","properties":{"uniprotId":{"type":"string"}},"required":["uniprotId"],"additionalProperties":false,"example":{"uniprotId":"P00533"}},{"type":"object","properties":{"symbol":{"type":"string"}},"required":["symbol"],"additionalProperties":false,"example":{"symbol":"EGFR"}},{"type":"object","properties":{"omimId":{"type":"string"}},"required":["omimId"],"additionalProperties":false,"example":{"omimId":"131550"}},{"type":"object","properties":{"orphanet":{"type":"string"}},"required":["orphanet"],"additionalProperties":false,"example":{"orphanet":"30815"}},{"type":"object","properties":{"iuphar":{"type":"string"}},"required":["iuphar"],"additionalProperties":false,"example":{"iuphar":"1797"}}]},"PatentCoreRecord":{"type":"object","properties":{"amassId":{"type":"string"},"publicationNumber":{"type":["string","null"],"description":"Publication number of the patent (e.g. US-10266485-B2). The source-neutral identity key."},"applicationNumber":{"type":["string","null"],"description":"Application number of the patent."},"countryCode":{"type":["string","null"],"description":"Jurisdiction / patent-office code (e.g. US, EP, WO, CN)."},"kindCode":{"type":["string","null"],"description":"Publication kind code indicating the document type/stage (e.g. A1, B2)."},"familyId":{"type":["string","null"],"description":"Patent family identifier grouping publications of the same invention across jurisdictions."},"familyMembers":{"type":"array","items":{"type":"string"},"description":"PatentCore Amass IDs (AMPC_…) of the other members of this patent's family that were collapsed into this result (siblings across jurisdictions/stages) — dereference each via the get/batch endpoint. Empty when family collapse is off or no siblings were found."},"title":{"type":["string","null"],"description":"Patent title (English-preferred)."},"abstract":{"type":["string","null"],"description":"Patent abstract (English-preferred)."},"language":{"type":["string","null"],"description":"Language of the full text."},"nonEnglishFallback":{"type":["boolean","null"],"description":"True when the text is the original non-English language (no English text was available)."},"cpcCodes":{"type":"array","items":{"type":"string"},"description":"Cooperative Patent Classification (CPC) codes."},"ipcCodes":{"type":"array","items":{"type":"string"},"description":"International Patent Classification (IPC) codes."},"inventors":{"type":"array","items":{"type":"string"},"description":"Inventor names."},"assignees":{"type":"array","items":{"type":"string"},"description":"Assignee / applicant names."},"publicationDate":{"type":["string","null"],"format":"date","description":"Date the document entered the public record (~18 months after filing for applications).","example":"2019-04-23"},"filingDate":{"type":["string","null"],"format":"date","description":"Date this application was filed at this office; anchors the 20-year term.","example":"2016-01-01"},"grantDate":{"type":["string","null"],"format":"date","description":"Grant/issue date; null for pending or never-granted applications, so a grant-date filter implicitly restricts to granted patents.","example":"2019-04-23"},"priorityDate":{"type":["string","null"],"format":"date","description":"Earliest priority date — the invention's effective date and the correct field for prior-art and innovation-trend queries.","example":"2015-01-01"},"citedPatents":{"type":"array","items":{"type":"string"},"description":"BACKWARD citations (prior art this patent cites): PatentCore Amass IDs (AMPC_…) of the earlier patents THIS patent points to — dereference each via the get/batch endpoint. Returned by default. Cited patents outside our life-science corpus are dropped, so this list can be shorter than the patent's true backward-citation count."},"priorityClaimNumbers":{"type":"array","items":{"type":"string"},"description":"Publication numbers claimed as priority."},"parentPublicationNumbers":{"type":"array","items":{"type":"string"},"description":"Parent publication numbers in the lineage."},"childPublicationNumbers":{"type":"array","items":{"type":"string"},"description":"Child publication numbers in the lineage."},"hasClaims":{"type":["boolean","null"],"description":"Whether the patent has claims text."},"hasDescription":{"type":["boolean","null"],"description":"Whether the patent has a description."},"nplCount":{"type":["number","null"],"description":"BACKWARD citation count: how many non-patent-literature references (papers, books, standards) this patent cites. The full list is opt-in via ?include=nplCitations, so this count is returned by default in its place."},"citedByCount":{"type":["number","null"],"description":"FORWARD citation count: how many LATER patents cite THIS one — a downstream-impact signal that grows over time. The list of those patents is opt-in via ?include=citedByPatents; this count stays exact even when that list is capped."},"claims":{"type":["string","null"],"description":"Full claims text. Included with ?include=claims."},"description":{"type":["string","null"],"description":"Full description text. Included with ?include=description."},"nplCitations":{"type":"array","items":{"type":"string"},"description":"BACKWARD citations: raw non-patent-literature reference strings (papers, books, standards) this patent cites. Count is nplCount. Included with ?include=nplCitations."},"citedByPatents":{"type":"array","items":{"type":"string"},"description":"FORWARD citations: PatentCore Amass IDs (AMPC_…) of LATER patents that cite THIS one (who points at it) — dereference each via the get/batch endpoint. Count is citedByCount, which stays exact even though this list drops citing patents outside our life-science corpus. Included with ?include=citedByPatents."},"referencesDrugCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to DrugCore: Amass IDs of DrugCore records (drugs) disclosed in or linked to this patent, resolved from the patent's ChEMBL ids. Included with ?include=referencesDrugCore."},"referencesBiomedCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to BiomedCore: Amass IDs (AMBC_…) of BiomedCore papers this patent cites, resolved from the DOIs regex-extracted from its non-patent-literature citations. DOIs with no BiomedCore paper (outside our life-science corpus) are dropped. Included with ?include=referencesBiomedCore."}},"required":["amassId","publicationNumber","applicationNumber","countryCode","kindCode","familyId","familyMembers","title","abstract","language","nonEnglishFallback","cpcCodes","ipcCodes","inventors","assignees","publicationDate","filingDate","grantDate","priorityDate","citedPatents","priorityClaimNumbers","parentPublicationNumbers","childPublicationNumbers","hasClaims","hasDescription","nplCount","citedByCount"]},"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":"string","format":"date","description":"Earliest date Amass last wrote the record. Any ingested change moves it — the citation itself, PMC fulltext arriving, a citation count refreshing, or cross-core links updating. Records with no such date are excluded.","example":"2026-01-01"},"required":false,"description":"Earliest date Amass last wrote the record. Any ingested change moves it — the citation itself, PMC fulltext arriving, a citation count refreshing, or cross-core links updating. Records with no such date are excluded.","name":"minLastUpdateDate","in":"query"},{"schema":{"type":"string","format":"date","description":"Latest date Amass last wrote the record. Pair with minLastUpdateDate to close a window: search returns a ranked top-K, so a wide window can truncate — request long spans in slices and union the results, or use /changes for complete coverage.","example":"2026-01-01"},"required":false,"description":"Latest date Amass last wrote the record. Pair with minLastUpdateDate to close a window: search returns a ranked top-K, so a wide window can truncate — request long spans in slices and union the results, or use /changes for complete coverage.","name":"maxLastUpdateDate","in":"query"},{"schema":{"type":"string","format":"date","description":"Earliest date the record entered Amass. Filters on when Amass ingested the record, not when it was published — use this to find recently added literature regardless of publication date. Records with no create date are excluded.","example":"2026-01-01"},"required":false,"description":"Earliest date the record entered Amass. Filters on when Amass ingested the record, not when it was published — use this to find recently added literature regardless of publication date. Records with no create date are excluded.","name":"minCreateDate","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"],"example":{"items":[{"pmid":"38123456"},{"doi":"10.1038/s41586-024-00001-x"}]}}}}},"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/biomedcore/changes":{"get":{"operationId":"listBiomedCoreChanges","tags":["cores/biomedcore"],"summary":"Changes","description":"A resumable feed of BiomedCore records that were created, updated, or deleted, for keeping a local copy in sync without re-reading the corpus. Read `updateType` to tell them apart.\n\nDeletions ride this feed rather than a separate one, under the same cursor. Two cursors over one record space can disagree: a record deleted on one day and re-created on a later one is applied in the wrong order by a consumer further along one feed than the other, and nothing would re-deliver it. Deleted items carry no `createDate`.\n\nA deletion means the provider withdrew the citation outright, which is rare. A **retraction** is not a deletion — retracted papers stay indexed and appear here as an `isRetracted` change.\n\nPass `amassId` (repeat it once per publication, up to 100) to follow only those publications rather than the whole corpus — the papers behind one review, say. Nothing else changes: deletions still arrive and paging works the same way. Over 100 publications, sweep in chunks of 100 and chunk the same way on every run: a cursor is bound to the exact set it was issued for, so changing that set means starting again from `since`.\n\n**Expect volume.** Citation-count refreshes are genuine record changes and are reported as such, and they touch far more records than new publications do — a window that pages quickly on TrialCore can run much longer here. Size `limit` accordingly and follow the cursor, or scope the feed with `amassId`.\n\nDelivery is at-least-once — upsert by `amassId`. A page may hold fewer than `limit` items and still have a `nextCursor`: `limit` bounds the rows the feed scans, not the items it returns, so a day boundary or a record that changed more than once on one day both under-fill a page. Follow the cursor until it is null, which is the only signal that you are caught up.\n\nThe most recent day is always withheld, so an ingest still in progress cannot serve a half-written day and strand the rest behind your cursor. A caught-up feed is therefore caught up through an earlier day than today: set the next run's `since` a day or two before the last one and let the at-least-once upsert absorb the overlap.","parameters":[{"schema":{"type":"string","format":"date","description":"Start of the change window, inclusive.","example":"2026-01-01"},"required":true,"description":"Start of the change window, inclusive.","name":"since","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":1000,"default":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","description":"Opaque cursor from a previous response's `nextCursor`. `since` is still honoured, but paging resumes from the cursor's position. A cursor is bound to the `amassId` set it was issued under; changing that set invalidates it."},"required":false,"description":"Opaque cursor from a previous response's `nextCursor`. `since` is still honoured, but paging resumes from the cursor's position. A cursor is bound to the `amassId` set it was issued under; changing that set invalidates it.","name":"cursor","in":"query"},{"schema":{"type":"array","items":{"type":"string"},"maxItems":100},"required":false,"name":"amassId","in":"query","style":"form","explode":true,"description":"Restrict the feed to these records. Repeat the parameter once per record, at most 100 per request — a comma-separated list is read as a single identifier and rejected. Omit it to follow the whole corpus. Scoping narrows what comes back without weakening anything — deletions still surface, and paging works the same way. For more than 100 records, sweep in chunks of 100 and chunk the same way on every run: a cursor is bound to the exact set it was issued for, so changing that set means starting again from `since`. On this Core scoping is also the practical way to avoid the citation-refresh volume."},{"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/BiomedCoreChangedRecord"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"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":"string","format":"date","description":"Earliest date Amass last wrote the record. Any ingested change moves it, so it answers \"is what I hold current\"; it is observed by Amass, not the source registry's own claim. Records with no such date are excluded.","example":"2026-01-01"},"required":false,"description":"Earliest date Amass last wrote the record. Any ingested change moves it, so it answers \"is what I hold current\"; it is observed by Amass, not the source registry's own claim. Records with no such date are excluded.","name":"minLastUpdateDate","in":"query"},{"schema":{"type":"string","format":"date","description":"Latest date Amass last wrote the record. Pair with minLastUpdateDate to close a window: search returns a ranked top-K, so a wide window can truncate — request long spans in slices and union the results, or use /changes for complete coverage.","example":"2026-01-01"},"required":false,"description":"Latest date Amass last wrote the record. Pair with minLastUpdateDate to close a window: search returns a ranked top-K, so a wide window can truncate — request long spans in slices and union the results, or use /changes for complete coverage.","name":"maxLastUpdateDate","in":"query"},{"schema":{"type":"string","format":"date","description":"Earliest date the record entered Amass. Records with no create date are excluded.","example":"2026-01-01"},"required":false,"description":"Earliest date the record entered Amass. Records with no create date are excluded.","name":"minCreateDate","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["detailedDescription","outcomes","referencesBiomedCore","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":{"$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","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":{"$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 NCT ID or registry ID. `registryId` is the source-registry native id and resolves any trial — including non-US (ICTRP) trials, which have no NCT 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":{"nctId":{"type":"string"}},"required":["nctId"],"additionalProperties":false},{"type":"object","properties":{"registryId":{"type":"string"}},"required":["registryId"],"additionalProperties":false}]}}},"required":["items"],"example":{"items":[{"nctId":"NCT06012345"},{"registryId":"EUCTR2021-000123-45"}]}}}}},"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},{"type":"object","properties":{"registryId":{"type":"string"}},"required":["registryId"],"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/trialcore/changes":{"get":{"operationId":"listTrialCoreChanges","tags":["cores/trialcore"],"summary":"Changes","description":"A resumable feed of TrialCore records that were created, updated, or deleted, for keeping a local copy in sync without re-reading the corpus. Read `updateType` to tell them apart.\n\nDeletions ride this feed rather than a separate one, under the same cursor. Two cursors over one record space can disagree: a trial deleted on one day and re-created on a later one is applied in the wrong order by a consumer further along one feed than the other, and nothing would re-deliver it. Deleted items carry no `createDate`.\n\nCovers changes to the trial record **and** to its posted results: a results-only revision leaves the trial record itself unchanged, so a consumer watching `lastUpdateDate` alone would never see it.\n\nPass `amassId` (repeat it once per trial, up to 100) to follow only those trials rather than the whole corpus — a tracked portfolio, say. Nothing else changes: deletions and results revisions still arrive, and paging works the same way. Over 100 trials, sweep in chunks of 100 and chunk the same way on every run: a cursor is bound to the exact set it was issued for, so changing that set means starting again from `since`.\n\nDelivery is at-least-once — upsert by `amassId`. A page may hold fewer than `limit` items and still have a `nextCursor`: `limit` bounds the rows the feed scans, not the items it returns, so a day boundary or a record that changed more than once on one day both under-fill a page. Follow the cursor until it is null, which is the only signal that you are caught up.\n\nThe most recent day is always withheld, so an ingest still in progress cannot serve a half-written day and strand the rest behind your cursor. A caught-up feed is therefore caught up through an earlier day than today: set the next run's `since` a day or two before the last one and let the at-least-once upsert absorb the overlap.\n\nNote that a halted trial is **not** a deletion — withdrawn and terminated trials stay indexed and appear here as an `overallStatus` change.","parameters":[{"schema":{"type":"string","format":"date","description":"Start of the change window, inclusive.","example":"2026-01-01"},"required":true,"description":"Start of the change window, inclusive.","name":"since","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":1000,"default":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","description":"Opaque cursor from a previous response's `nextCursor`. `since` is still honoured, but paging resumes from the cursor's position. A cursor is bound to the `amassId` set it was issued under; changing that set invalidates it."},"required":false,"description":"Opaque cursor from a previous response's `nextCursor`. `since` is still honoured, but paging resumes from the cursor's position. A cursor is bound to the `amassId` set it was issued under; changing that set invalidates it.","name":"cursor","in":"query"},{"schema":{"type":"array","items":{"type":"string"},"maxItems":100},"required":false,"name":"amassId","in":"query","style":"form","explode":true,"description":"Restrict the feed to these records. Repeat the parameter once per record, at most 100 per request — a comma-separated list is read as a single identifier and rejected. Omit it to follow the whole corpus. Scoping narrows what comes back without weakening anything — deletions and results revisions still surface, and paging works the same way. For more than 100 records, sweep in chunks of 100 and chunk the same way on every run: a cursor is bound to the exact set it was issued for, so changing that set means starting again from `since`."},{"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/TrialCoreChangedRecord"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"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"],"example":{"items":[{"fdaApplicationNumber":"BLA125514"},{"emaProductNumber":"EMEA/H/C/003820"},{"ndc":"0169-4404"},{"splSetId":"ffffffff-ffff-ffff-ffff-ffffffffffff"}]}}}}},"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","referencesGeneCore"]}},"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."},"referencesGeneCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to GeneCore: Amass IDs of GeneCore records (genes) targeted by this drug, resolved from the drug's mechanism-of-action target Ensembl gene IDs. Included with ?include=referencesGeneCore."},"mechanismsOfAction":{"type":"array","items":{"type":"object","properties":{"actionType":{"type":["string","null"],"description":"How the drug interacts with its target (e.g. INHIBITOR, ACTIVATOR)"},"mechanismOfAction":{"type":["string","null"],"description":"Free-text description of the drug's pharmacological action"},"targetType":{"type":["string","null"],"description":"Classification of the target's biological category (e.g. 'single protein', 'protein complex')"},"targets":{"type":"array","items":{"type":"object","properties":{"ensemblId":{"type":"string","description":"Ensembl gene identifier of the drug target (e.g. ENSG00000095303)"},"symbol":{"type":["string","null"],"description":"HGNC approved gene symbol (e.g. PTGS1)"},"name":{"type":["string","null"],"description":"Gene / target name"},"synonyms":{"type":"array","items":{"type":"string"},"description":"HGNC alias and previous gene symbols"}},"required":["ensemblId","symbol","name","synonyms"]},"description":"Biological targets the drug acts on, enriched with HGNC gene metadata"}},"required":["actionType","mechanismOfAction","targetType","targets"]},"description":"Mechanisms of action for the drug: how the drug interacts with each pharmacological target, the mode of action, target type, and the targets themselves (Ensembl gene IDs enriched with HGNC symbol, name and synonyms). The targets resolve to GeneCore records via referencesGeneCore."}},"required":["amassId","chemblId","name","description","synonyms","tradeNames","drugType","maxClinicalStage","inchiKey","canonicalSmiles","mechanismsOfAction"]}}},"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","referencesGeneCore"]}},"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."},"referencesGeneCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to GeneCore: Amass IDs of GeneCore records (genes) targeted by this drug, resolved from the drug's mechanism-of-action target Ensembl gene IDs. Included with ?include=referencesGeneCore."},"mechanismsOfAction":{"type":"array","items":{"type":"object","properties":{"actionType":{"type":["string","null"],"description":"How the drug interacts with its target (e.g. INHIBITOR, ACTIVATOR)"},"mechanismOfAction":{"type":["string","null"],"description":"Free-text description of the drug's pharmacological action"},"targetType":{"type":["string","null"],"description":"Classification of the target's biological category (e.g. 'single protein', 'protein complex')"},"targets":{"type":"array","items":{"type":"object","properties":{"ensemblId":{"type":"string","description":"Ensembl gene identifier of the drug target (e.g. ENSG00000095303)"},"symbol":{"type":["string","null"],"description":"HGNC approved gene symbol (e.g. PTGS1)"},"name":{"type":["string","null"],"description":"Gene / target name"},"synonyms":{"type":"array","items":{"type":"string"},"description":"HGNC alias and previous gene symbols"}},"required":["ensemblId","symbol","name","synonyms"]},"description":"Biological targets the drug acts on, enriched with HGNC gene metadata"}},"required":["actionType","mechanismOfAction","targetType","targets"]},"description":"Mechanisms of action for the drug: how the drug interacts with each pharmacological target, the mode of action, target type, and the targets themselves (Ensembl gene IDs enriched with HGNC symbol, name and synonyms). The targets resolve to GeneCore records via referencesGeneCore."}},"required":["amassId","chemblId","name","description","synonyms","tradeNames","drugType","maxClinicalStage","inchiKey","canonicalSmiles","mechanismsOfAction"]}},"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"],"example":{"items":[{"chemblId":"CHEMBL1201583"},{"chemblId":"CHEMBL25"}]}}}}},"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/cores/genecore/records":{"get":{"operationId":"searchGeneCoreRecords","tags":["cores/genecore"],"summary":"Search","description":"Search GeneCore records. Keyword search across gene symbols, names, synonyms, gene families, RefSeq functional summaries, UniProt keywords, and ChEMBL target class.","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":["PROTEIN_CODING","NCRNA","PSEUDO","TRNA","RRNA","SNRNA","SCRNA","SNORNA","MISCRNA","BIOLOGICAL_REGION","TRANSPOSON","OTHER"]}},"required":false,"name":"geneType","in":"query","style":"form","explode":true,"description":"Match ANY of these NCBI gene types / biotypes. Repeat the param for multiple values (e.g. `geneType=PROTEIN_CODING&geneType=NCRNA`)."},{"schema":{"type":"string","enum":["true","false"],"example":"true"},"required":false,"name":"isDruggable","in":"query","description":"Keep only druggable targets (any small-molecule or antibody tractability bucket)."},{"schema":{"type":"string","enum":["true","false"],"example":"true"},"required":false,"name":"isEssential","in":"query","description":"Filter by CRISPR dependency-screen essentiality (`true` = essential for cell viability)."},{"schema":{"type":"array","items":{"type":"string","enum":["ENZYME","MEMBRANE_RECEPTOR","ION_CHANNEL","TRANSPORTER","TRANSCRIPTION_FACTOR","EPIGENETIC_REGULATOR","SECRETED_PROTEIN","SURFACE_ANTIGEN","STRUCTURAL_PROTEIN","ADHESION","OTHER_CYTOSOLIC_PROTEIN","OTHER_NUCLEAR_PROTEIN","AUXILIARY_TRANSPORT_PROTEIN","UNCLASSIFIED_PROTEIN"]}},"required":false,"name":"targetClass","in":"query","style":"form","explode":true,"description":"Match ANY of these top-level ChEMBL target classes. Repeat to match ANY. The full class path is still returned in each record."},{"schema":{"type":"array","items":{"type":"string","enum":["SMALL_MOLECULE","ANTIBODY","PROTAC","OTHER_CLINICAL"]}},"required":false,"name":"tractabilityModality","in":"query","style":"form","explode":true,"description":"Match targets with clinical-precedent tractability by drug modality. Alone it matches any clinical stage; pair with `tractabilityStage` to require a stage. Repeat to match ANY."},{"schema":{"type":"array","items":{"type":"string","enum":["APPROVED_DRUG","ADVANCED_CLINICAL","PHASE_1_CLINICAL"]}},"required":false,"name":"tractabilityStage","in":"query","style":"form","explode":true,"description":"Match targets whose tractability has reached this clinical-precedent stage. Alone it matches any modality; pair with `tractabilityModality` to require a modality. Repeat to match ANY."},{"schema":{"type":"string","enum":["true","false"],"example":"true"},"required":false,"name":"hasSafetyLiabilities","in":"query","description":"Keep only genes that carry at least one curated target-safety liability. The liability details are returned in each record's `safetyLiabilities` field."},{"schema":{"type":"number","minimum":0,"description":"Keep genes with gnomAD v4.0 LOEUF <= this value (lower LOEUF = more loss-of-function-constrained). gnomAD recommends LOEUF < 0.6 as the v4.0 constrained threshold."},"required":false,"description":"Keep genes with gnomAD v4.0 LOEUF <= this value (lower LOEUF = more loss-of-function-constrained). gnomAD recommends LOEUF < 0.6 as the v4.0 constrained threshold.","name":"maxConstraintLoeuf","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["protein","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":"AMGC_..."},"ensemblGeneId":{"type":["string","null"],"description":"Ensembl stable gene identifier (e.g. ENSG00000141510)"},"symbol":{"type":["string","null"],"description":"Approved gene symbol (e.g. TP53)"},"name":{"type":["string","null"],"description":"Full gene name"},"synonyms":{"type":"array","items":{"type":"string"},"description":"Alternative symbols / aliases for the gene"},"geneType":{"type":["string","null"],"description":"NCBI gene type / biotype: 'PROTEIN_CODING', 'NCRNA', 'PSEUDO', 'TRNA', 'RRNA', 'SNRNA', 'SCRNA', 'SNORNA', 'MISCRNA', 'BIOLOGICAL_REGION', 'TRANSPOSON', 'OTHER'"},"summary":{"type":["string","null"],"description":"NCBI RefSeq curated free-text functional description of the gene"},"location":{"type":["string","null"],"description":"Cytogenetic location / chromosomal band (e.g. 17p13.1)"},"chromosome":{"type":["string","null"],"description":"Chromosome the gene resides on (e.g. '17', 'X'), from Ensembl"},"strand":{"type":["string","null"],"description":"Genomic strand: '+' (forward) or '-' (reverse), from Ensembl"},"entrezGeneId":{"type":["string","null"],"description":"NCBI Entrez gene identifier"},"hgncId":{"type":["string","null"],"description":"HGNC identifier (e.g. HGNC:11998)"},"uniprotIds":{"type":"array","items":{"type":"string"},"description":"Associated UniProt accession(s)"},"hgncGeneGroups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable HGNC gene-group id (e.g. '1332')."},"name":{"type":"string","description":"HGNC gene-group / family name (e.g. 'MTOR complex 1')."}},"required":["id","name"]},"description":"HGNC gene groups (gene families) the gene belongs to — each pairing a stable HGNC group id with its name, resolvable at genenames.org/data/genegroup."},"maneSelect":{"type":"array","items":{"type":"string"},"description":"MANE Select canonical transcript id(s) (RefSeq + Ensembl)"},"omimId":{"type":"array","items":{"type":"string"},"description":"OMIM identifier(s) for associated Mendelian disease/phenotype"},"orphanet":{"type":["string","null"],"description":"Orphanet rare-disease identifier"},"iuphar":{"type":["string","null"],"description":"IUPHAR/Guide to Pharmacology target identifier"},"tractability":{"type":["object","null"],"properties":{"smallMolecule":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]},"antibody":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]},"protac":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]},"otherClinical":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]}},"required":["smallMolecule","antibody","protac","otherClinical"],"description":"Tractability by modality (small molecule, antibody, PROTAC/degrader, other clinical): the satisfied druggability buckets, split into clinical precedent vs. predictive evidence."},"safetyLiabilities":{"type":["array","null"],"items":{"type":"object","properties":{"event":{"type":["string","null"],"description":"The adverse event / safety term (e.g. 'cardiotoxicity')."},"datasource":{"type":["string","null"],"description":"Curating source for the signal, as reported upstream."},"url":{"type":["string","null"],"description":"Datasource link for the gene."},"effects":{"type":"array","items":{"type":"object","properties":{"direction":{"type":["string","null"],"description":"e.g. 'inhibition' / 'activation'."},"dosing":{"type":["string","null"],"description":"e.g. 'general' / 'chronic'."}},"required":["direction","dosing"]},"description":"Modulation direction/dosing that produces the event."},"biosamples":{"type":"array","items":{"type":"string"},"description":"Cell/tissue labels the signal was observed in (e.g. ['HepaRG'])."},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Triggering drug ('sorafenib induced effect') or assay name."},"type":{"type":["string","null"],"description":"'clinical' | 'cell-based' | ..."}},"required":["name","type"]},"description":"Triggering drugs / assays."}},"required":["event","datasource","url","effects","biosamples","sources"]},"description":"Curated safety liabilities (adverse events / target safety signals), each with its datasource, source drugs/assays, and any modulation effects."},"targetClass":{"type":["object","null"],"properties":{"path":{"type":"array","items":{"type":"string"},"description":"ChEMBL target-class labels, broadest first (e.g. ['Enzyme', 'Transferase'])."},"leafChemblClassId":{"type":["number","null"],"description":"ChEMBL protein-classification id of the most specific (leaf) class in the path."}},"required":["path","leafChemblClassId"],"description":"ChEMBL target-class hierarchy: an ordered path from broadest class to most specific (e.g. Enzyme → Transferase), plus the leaf ChEMBL class id."},"gnomadConstraint":{"type":["object","null"],"properties":{"synonymous":{"type":["object","null"],"properties":{"observed":{"type":["number","null"]},"expected":{"type":["number","null"]},"oe":{"type":["number","null"],"description":"Observed/expected variant ratio (< 1 = depleted = constrained)."},"oeLower":{"type":["number","null"]},"oeUpper":{"type":["number","null"]},"constraintZ":{"type":["number","null"],"description":"Constraint Z-score; higher = more depleted than expected."}},"required":["observed","expected","oe","oeLower","oeUpper","constraintZ"]},"missense":{"type":["object","null"],"properties":{"observed":{"type":["number","null"]},"expected":{"type":["number","null"]},"oe":{"type":["number","null"],"description":"Observed/expected variant ratio (< 1 = depleted = constrained)."},"oeLower":{"type":["number","null"]},"oeUpper":{"type":["number","null"]},"constraintZ":{"type":["number","null"],"description":"Constraint Z-score; higher = more depleted than expected."}},"required":["observed","expected","oe","oeLower","oeUpper","constraintZ"]},"lossOfFunction":{"type":["object","null"],"properties":{"observed":{"type":["number","null"]},"expected":{"type":["number","null"]},"oe":{"type":["number","null"]},"oeLower":{"type":["number","null"]},"oeUpper":{"type":["number","null"],"description":"LOEUF (gnomAD v4.0 loss-of-function observed/expected upper-bound fraction) — lower = more LoF-intolerant. Best used as a continuous metric; gnomAD recommends LOEUF < 0.6 as the v4.0 constrained threshold (it was < 0.35 for v2). Mirrored under `loeuf`."},"loeuf":{"type":["number","null"],"description":"LOEUF — identical to `oeUpper`, surfaced under its own name so it is discoverable and matches the `maxConstraintLoeuf` filter param. Lower = more LoF-intolerant; gnomAD recommends LOEUF < 0.6 for v4.0."},"pli":{"type":["number","null"],"description":"gnomAD v4.0 pLI — probability of LoF-intolerance (recommended cutoff: >= 0.9 = intolerant)."},"loeufDecile":{"type":["number","null"],"description":"LOEUF decile (0 = most-constrained bucket)."},"loeufRank":{"type":["number","null"],"description":"Genome-wide LOEUF rank (lower = more constrained)."}},"required":["observed","expected","oe","oeLower","oeUpper","loeuf","pli","loeufDecile","loeufRank"]}},"required":["synonymous","missense","lossOfFunction"],"description":"Genetic-constraint summary from gnomAD v4.0 Gene Constraint, keyed by variant class (synonymous/missense/lossOfFunction): observed-vs-expected depletion, plus pLI and LOEUF loss-of-function intolerance (LOEUF in `lossOfFunction.loeuf`; gnomAD recommends LOEUF < 0.6 for v4.0)."},"depmapEssentiality":{"type":["object","null"],"properties":{"isEssential":{"type":"boolean","description":"Gene-level flag: the gene is a dependency in at least one screen."},"cellLinesTested":{"type":"number","description":"Number of cell lines with a gene-effect measurement."},"dependentCellLines":{"type":"number","description":"Cell lines whose gene-effect is below the dependency cutoff (< -0.5)."},"meanGeneEffect":{"type":["number","null"],"description":"Mean gene-effect across screens."},"medianGeneEffect":{"type":["number","null"],"description":"Median gene-effect across screens."},"minGeneEffect":{"type":["number","null"],"description":"Most negative gene-effect observed (the strongest dependency)."},"topDependencies":{"type":"array","items":{"type":"object","properties":{"cellLineName":{"type":["string","null"]},"depmapId":{"type":["string","null"]},"tissue":{"type":["string","null"]},"disease":{"type":["string","null"]},"geneEffect":{"type":"number","description":"Gene-effect score (more negative = stronger dependency)."},"expression":{"type":["number","null"],"description":"Gene expression in the cell line, log2(TPM+1)."}},"required":["cellLineName","depmapId","tissue","disease","geneEffect","expression"]},"description":"Most-dependent cell lines, ascending by gene-effect (capped at 10)."}},"required":["isEssential","cellLinesTested","dependentCellLines","meanGeneEffect","medianGeneEffect","minGeneEffect","topDependencies"],"description":"Gene-essentiality summary from CRISPR dependency screens: a dependency flag, the gene-effect distribution, and the most-dependent cell lines (selective essentiality)."},"protein":{"type":["object","null"],"properties":{"identity":{"type":"object","properties":{"canonicalAccession":{"type":["string","null"],"description":"The reviewed UniProt accession whose annotations populate the prose fields below."},"entryName":{"type":["string","null"],"description":"UniProt entry name (e.g. 'P53_HUMAN')."},"annotationScore":{"type":["number","null"],"description":"UniProt annotation score 1–5 (curation depth)."},"evidenceLevel":{"type":["string","null"],"description":"Protein existence evidence (e.g. 'Evidence at protein level')."},"mappedAccessions":{"type":"array","items":{"type":"string"},"description":"All matched reviewed accessions — populated ONLY when the gene maps to >1 entry (i.e. this block collapsed several proteins); empty for the single-entry common case."}},"required":["canonicalAccession","entryName","annotationScore","evidenceLevel","mappedAccessions"]},"function":{"type":"object","properties":{"functionSummary":{"type":["string","null"],"description":"Curated description of the protein's function."},"associatedDiseases":{"type":["string","null"],"description":"UniProt disease involvement text."},"tissueSpecificity":{"type":["string","null"]},"keywords":{"type":"array","items":{"type":"string"},"description":"UniProt keywords (unioned across matched entries)."},"subcellularLocations":{"type":"array","items":{"type":"string"}}},"required":["functionSummary","associatedDiseases","tissueSpecificity","keywords","subcellularLocations"]},"biophysics":{"type":"object","properties":{"sequenceLength":{"type":["number","null"],"description":"Canonical sequence length (residues)."},"molecularMassDa":{"type":["number","null"],"description":"Molecular mass in daltons."},"ecNumbers":{"type":"array","items":{"type":"string"},"description":"Enzyme Commission numbers (unioned across matched entries)."},"ptmSummary":{"type":["string","null"],"description":"Post-translational-modification description."},"ptmTypes":{"type":"array","items":{"type":"string"}}},"required":["sequenceLength","molecularMassDa","ecNumbers","ptmSummary","ptmTypes"]},"structure":{"type":"object","properties":{"has3dStructure":{"type":["boolean","null"],"description":"Whether any PDB structure exists."},"pdbIds":{"type":"array","items":{"type":"string"}},"pfamIds":{"type":"array","items":{"type":"string"}},"interproIds":{"type":"array","items":{"type":"string"}}},"required":["has3dStructure","pdbIds","pfamIds","interproIds"]}},"required":["identity","function","biophysics","structure"],"description":"Representative UniProt Swiss-Prot protein for the gene — identity, function/disease, biophysics (sequence, mass, EC, PTMs), and structure (PDB/Pfam/InterPro). `null` when the gene encodes no reviewed protein. Included with ?include=protein."},"referencesDrugCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to DrugCore: Amass IDs of DrugCore records (drugs) that target this gene. Included with ?include=referencesDrugCore."}},"required":["amassId","ensemblGeneId","symbol","name","synonyms","geneType","summary","location","chromosome","strand","entrezGeneId","hgncId","uniprotIds","hgncGeneGroups","maneSelect","omimId","orphanet","iuphar","tractability","safetyLiabilities","targetClass","gnomadConstraint","depmapEssentiality"]}}},"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/genecore/records/{amassId}":{"get":{"operationId":"getGeneCoreRecordByAmassId","tags":["cores/genecore"],"summary":"Get record","description":"Get GeneCore record by Amass ID","parameters":[{"schema":{"type":"string","example":"AMGC_..."},"required":true,"name":"amassId","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["protein","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":"AMGC_..."},"ensemblGeneId":{"type":["string","null"],"description":"Ensembl stable gene identifier (e.g. ENSG00000141510)"},"symbol":{"type":["string","null"],"description":"Approved gene symbol (e.g. TP53)"},"name":{"type":["string","null"],"description":"Full gene name"},"synonyms":{"type":"array","items":{"type":"string"},"description":"Alternative symbols / aliases for the gene"},"geneType":{"type":["string","null"],"description":"NCBI gene type / biotype: 'PROTEIN_CODING', 'NCRNA', 'PSEUDO', 'TRNA', 'RRNA', 'SNRNA', 'SCRNA', 'SNORNA', 'MISCRNA', 'BIOLOGICAL_REGION', 'TRANSPOSON', 'OTHER'"},"summary":{"type":["string","null"],"description":"NCBI RefSeq curated free-text functional description of the gene"},"location":{"type":["string","null"],"description":"Cytogenetic location / chromosomal band (e.g. 17p13.1)"},"chromosome":{"type":["string","null"],"description":"Chromosome the gene resides on (e.g. '17', 'X'), from Ensembl"},"strand":{"type":["string","null"],"description":"Genomic strand: '+' (forward) or '-' (reverse), from Ensembl"},"entrezGeneId":{"type":["string","null"],"description":"NCBI Entrez gene identifier"},"hgncId":{"type":["string","null"],"description":"HGNC identifier (e.g. HGNC:11998)"},"uniprotIds":{"type":"array","items":{"type":"string"},"description":"Associated UniProt accession(s)"},"hgncGeneGroups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable HGNC gene-group id (e.g. '1332')."},"name":{"type":"string","description":"HGNC gene-group / family name (e.g. 'MTOR complex 1')."}},"required":["id","name"]},"description":"HGNC gene groups (gene families) the gene belongs to — each pairing a stable HGNC group id with its name, resolvable at genenames.org/data/genegroup."},"maneSelect":{"type":"array","items":{"type":"string"},"description":"MANE Select canonical transcript id(s) (RefSeq + Ensembl)"},"omimId":{"type":"array","items":{"type":"string"},"description":"OMIM identifier(s) for associated Mendelian disease/phenotype"},"orphanet":{"type":["string","null"],"description":"Orphanet rare-disease identifier"},"iuphar":{"type":["string","null"],"description":"IUPHAR/Guide to Pharmacology target identifier"},"tractability":{"type":["object","null"],"properties":{"smallMolecule":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]},"antibody":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]},"protac":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]},"otherClinical":{"type":"object","properties":{"clinical":{"type":"array","items":{"type":"string"},"description":"Satisfied clinical-precedent buckets (Approved Drug / Advanced Clinical / Phase 1 Clinical)."},"predictive":{"type":"array","items":{"type":"string"},"description":"Satisfied predictive-evidence buckets (structural pockets, ligands, localization, ubiquitination, ...)."}},"required":["clinical","predictive"]}},"required":["smallMolecule","antibody","protac","otherClinical"],"description":"Tractability by modality (small molecule, antibody, PROTAC/degrader, other clinical): the satisfied druggability buckets, split into clinical precedent vs. predictive evidence."},"safetyLiabilities":{"type":["array","null"],"items":{"type":"object","properties":{"event":{"type":["string","null"],"description":"The adverse event / safety term (e.g. 'cardiotoxicity')."},"datasource":{"type":["string","null"],"description":"Curating source for the signal, as reported upstream."},"url":{"type":["string","null"],"description":"Datasource link for the gene."},"effects":{"type":"array","items":{"type":"object","properties":{"direction":{"type":["string","null"],"description":"e.g. 'inhibition' / 'activation'."},"dosing":{"type":["string","null"],"description":"e.g. 'general' / 'chronic'."}},"required":["direction","dosing"]},"description":"Modulation direction/dosing that produces the event."},"biosamples":{"type":"array","items":{"type":"string"},"description":"Cell/tissue labels the signal was observed in (e.g. ['HepaRG'])."},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Triggering drug ('sorafenib induced effect') or assay name."},"type":{"type":["string","null"],"description":"'clinical' | 'cell-based' | ..."}},"required":["name","type"]},"description":"Triggering drugs / assays."}},"required":["event","datasource","url","effects","biosamples","sources"]},"description":"Curated safety liabilities (adverse events / target safety signals), each with its datasource, source drugs/assays, and any modulation effects."},"targetClass":{"type":["object","null"],"properties":{"path":{"type":"array","items":{"type":"string"},"description":"ChEMBL target-class labels, broadest first (e.g. ['Enzyme', 'Transferase'])."},"leafChemblClassId":{"type":["number","null"],"description":"ChEMBL protein-classification id of the most specific (leaf) class in the path."}},"required":["path","leafChemblClassId"],"description":"ChEMBL target-class hierarchy: an ordered path from broadest class to most specific (e.g. Enzyme → Transferase), plus the leaf ChEMBL class id."},"gnomadConstraint":{"type":["object","null"],"properties":{"synonymous":{"type":["object","null"],"properties":{"observed":{"type":["number","null"]},"expected":{"type":["number","null"]},"oe":{"type":["number","null"],"description":"Observed/expected variant ratio (< 1 = depleted = constrained)."},"oeLower":{"type":["number","null"]},"oeUpper":{"type":["number","null"]},"constraintZ":{"type":["number","null"],"description":"Constraint Z-score; higher = more depleted than expected."}},"required":["observed","expected","oe","oeLower","oeUpper","constraintZ"]},"missense":{"type":["object","null"],"properties":{"observed":{"type":["number","null"]},"expected":{"type":["number","null"]},"oe":{"type":["number","null"],"description":"Observed/expected variant ratio (< 1 = depleted = constrained)."},"oeLower":{"type":["number","null"]},"oeUpper":{"type":["number","null"]},"constraintZ":{"type":["number","null"],"description":"Constraint Z-score; higher = more depleted than expected."}},"required":["observed","expected","oe","oeLower","oeUpper","constraintZ"]},"lossOfFunction":{"type":["object","null"],"properties":{"observed":{"type":["number","null"]},"expected":{"type":["number","null"]},"oe":{"type":["number","null"]},"oeLower":{"type":["number","null"]},"oeUpper":{"type":["number","null"],"description":"LOEUF (gnomAD v4.0 loss-of-function observed/expected upper-bound fraction) — lower = more LoF-intolerant. Best used as a continuous metric; gnomAD recommends LOEUF < 0.6 as the v4.0 constrained threshold (it was < 0.35 for v2). Mirrored under `loeuf`."},"loeuf":{"type":["number","null"],"description":"LOEUF — identical to `oeUpper`, surfaced under its own name so it is discoverable and matches the `maxConstraintLoeuf` filter param. Lower = more LoF-intolerant; gnomAD recommends LOEUF < 0.6 for v4.0."},"pli":{"type":["number","null"],"description":"gnomAD v4.0 pLI — probability of LoF-intolerance (recommended cutoff: >= 0.9 = intolerant)."},"loeufDecile":{"type":["number","null"],"description":"LOEUF decile (0 = most-constrained bucket)."},"loeufRank":{"type":["number","null"],"description":"Genome-wide LOEUF rank (lower = more constrained)."}},"required":["observed","expected","oe","oeLower","oeUpper","loeuf","pli","loeufDecile","loeufRank"]}},"required":["synonymous","missense","lossOfFunction"],"description":"Genetic-constraint summary from gnomAD v4.0 Gene Constraint, keyed by variant class (synonymous/missense/lossOfFunction): observed-vs-expected depletion, plus pLI and LOEUF loss-of-function intolerance (LOEUF in `lossOfFunction.loeuf`; gnomAD recommends LOEUF < 0.6 for v4.0)."},"depmapEssentiality":{"type":["object","null"],"properties":{"isEssential":{"type":"boolean","description":"Gene-level flag: the gene is a dependency in at least one screen."},"cellLinesTested":{"type":"number","description":"Number of cell lines with a gene-effect measurement."},"dependentCellLines":{"type":"number","description":"Cell lines whose gene-effect is below the dependency cutoff (< -0.5)."},"meanGeneEffect":{"type":["number","null"],"description":"Mean gene-effect across screens."},"medianGeneEffect":{"type":["number","null"],"description":"Median gene-effect across screens."},"minGeneEffect":{"type":["number","null"],"description":"Most negative gene-effect observed (the strongest dependency)."},"topDependencies":{"type":"array","items":{"type":"object","properties":{"cellLineName":{"type":["string","null"]},"depmapId":{"type":["string","null"]},"tissue":{"type":["string","null"]},"disease":{"type":["string","null"]},"geneEffect":{"type":"number","description":"Gene-effect score (more negative = stronger dependency)."},"expression":{"type":["number","null"],"description":"Gene expression in the cell line, log2(TPM+1)."}},"required":["cellLineName","depmapId","tissue","disease","geneEffect","expression"]},"description":"Most-dependent cell lines, ascending by gene-effect (capped at 10)."}},"required":["isEssential","cellLinesTested","dependentCellLines","meanGeneEffect","medianGeneEffect","minGeneEffect","topDependencies"],"description":"Gene-essentiality summary from CRISPR dependency screens: a dependency flag, the gene-effect distribution, and the most-dependent cell lines (selective essentiality)."},"protein":{"type":["object","null"],"properties":{"identity":{"type":"object","properties":{"canonicalAccession":{"type":["string","null"],"description":"The reviewed UniProt accession whose annotations populate the prose fields below."},"entryName":{"type":["string","null"],"description":"UniProt entry name (e.g. 'P53_HUMAN')."},"annotationScore":{"type":["number","null"],"description":"UniProt annotation score 1–5 (curation depth)."},"evidenceLevel":{"type":["string","null"],"description":"Protein existence evidence (e.g. 'Evidence at protein level')."},"mappedAccessions":{"type":"array","items":{"type":"string"},"description":"All matched reviewed accessions — populated ONLY when the gene maps to >1 entry (i.e. this block collapsed several proteins); empty for the single-entry common case."}},"required":["canonicalAccession","entryName","annotationScore","evidenceLevel","mappedAccessions"]},"function":{"type":"object","properties":{"functionSummary":{"type":["string","null"],"description":"Curated description of the protein's function."},"associatedDiseases":{"type":["string","null"],"description":"UniProt disease involvement text."},"tissueSpecificity":{"type":["string","null"]},"keywords":{"type":"array","items":{"type":"string"},"description":"UniProt keywords (unioned across matched entries)."},"subcellularLocations":{"type":"array","items":{"type":"string"}}},"required":["functionSummary","associatedDiseases","tissueSpecificity","keywords","subcellularLocations"]},"biophysics":{"type":"object","properties":{"sequenceLength":{"type":["number","null"],"description":"Canonical sequence length (residues)."},"molecularMassDa":{"type":["number","null"],"description":"Molecular mass in daltons."},"ecNumbers":{"type":"array","items":{"type":"string"},"description":"Enzyme Commission numbers (unioned across matched entries)."},"ptmSummary":{"type":["string","null"],"description":"Post-translational-modification description."},"ptmTypes":{"type":"array","items":{"type":"string"}}},"required":["sequenceLength","molecularMassDa","ecNumbers","ptmSummary","ptmTypes"]},"structure":{"type":"object","properties":{"has3dStructure":{"type":["boolean","null"],"description":"Whether any PDB structure exists."},"pdbIds":{"type":"array","items":{"type":"string"}},"pfamIds":{"type":"array","items":{"type":"string"}},"interproIds":{"type":"array","items":{"type":"string"}}},"required":["has3dStructure","pdbIds","pfamIds","interproIds"]}},"required":["identity","function","biophysics","structure"],"description":"Representative UniProt Swiss-Prot protein for the gene — identity, function/disease, biophysics (sequence, mass, EC, PTMs), and structure (PDB/Pfam/InterPro). `null` when the gene encodes no reviewed protein. Included with ?include=protein."},"referencesDrugCore":{"type":"array","items":{"type":"string"},"description":"Cross-core link to DrugCore: Amass IDs of DrugCore records (drugs) that target this gene. Included with ?include=referencesDrugCore."}},"required":["amassId","ensemblGeneId","symbol","name","synonyms","geneType","summary","location","chromosome","strand","entrezGeneId","hgncId","uniprotIds","hgncGeneGroups","maneSelect","omimId","orphanet","iuphar","tractability","safetyLiabilities","targetClass","gnomadConstraint","depmapEssentiality"]}},"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/genecore/records/lookup":{"post":{"operationId":"lookupGeneCoreRecords","tags":["cores/genecore"],"summary":"Lookup","description":"Lookup Amass IDs by a public gene identifier (Ensembl gene ID, HGNC ID, NCBI/Entrez gene ID, UniProt accession, gene symbol, OMIM ID, Orphanet ID, or IUPHAR ID). Each item carries exactly one identifier key.","parameters":[{"schema":{"type":"string","example":"Bearer ******"},"required":false,"name":"Authorization","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/GeneCoreLookupItem"}}},"required":["items"],"example":{"items":[{"ensemblGeneId":"ENSG00000146648"},{"hgncId":"HGNC:3236"},{"entrezGeneId":"1956"},{"uniprotId":"P00533"},{"symbol":"EGFR"},{"omimId":"131550"},{"orphanet":"30815"},{"iuphar":"1797"}]}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"input":{"$ref":"#/components/schemas/GeneCoreLookupItem"},"amassIds":{"type":"array","items":{"type":"string","example":"AMGC_..."}},"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/patentcore/records":{"get":{"operationId":"searchPatentCoreRecords","tags":["cores/patentcore"],"summary":"Search","description":"Search PatentCore records (preview) by keyword query, optionally narrowed by jurisdiction, classification, assignee/inventor, dates, and citation count. Full-text BM25 over title, abstract, claims, and description.","parameters":[{"schema":{"type":"string"},"required":true,"name":"query","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":200,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","example":"US,EP,WO"},"required":false,"name":"countryCode","in":"query"},{"schema":{"type":"string","example":"B2,A1","description":"Comma-separated WIPO ST.16 kind code(s) (e.g. A1, A2, B1, B2, U, S). Jurisdiction-specific and open-ended; match any."},"required":false,"description":"Comma-separated WIPO ST.16 kind code(s) (e.g. A1, A2, B1, B2, U, S). Jurisdiction-specific and open-ended; match any.","name":"kindCode","in":"query"},{"schema":{"type":"string","example":"en"},"required":false,"name":"language","in":"query"},{"schema":{"type":"string","example":"A61K,C07D"},"required":false,"name":"cpcCodes","in":"query"},{"schema":{"type":"string","example":"A61K31/00"},"required":false,"name":"ipcCodes","in":"query"},{"schema":{"type":"string","example":"Moderna,BioNTech"},"required":false,"name":"assignee","in":"query"},{"schema":{"type":"string","example":"Doe"},"required":false,"name":"inventor","in":"query"},{"schema":{"type":"string","enum":["true","false"],"example":"true"},"required":false,"name":"hasClaims","in":"query"},{"schema":{"type":"string","enum":["true","false"],"example":"true"},"required":false,"name":"hasDescription","in":"query"},{"schema":{"type":"string","format":"date","example":"2020-01-01"},"required":false,"name":"minPublicationDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2024-12-31"},"required":false,"name":"maxPublicationDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2018-01-01"},"required":false,"name":"minFilingDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2024-12-31"},"required":false,"name":"maxFilingDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2020-01-01"},"required":false,"name":"minGrantDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2024-12-31"},"required":false,"name":"maxGrantDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2015-01-01"},"required":false,"name":"minPriorityDate","in":"query"},{"schema":{"type":"string","format":"date","example":"2024-12-31"},"required":false,"name":"maxPriorityDate","in":"query"},{"schema":{"type":"number","example":10,"minimum":0},"required":false,"name":"minCitedByCount","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["claims","description","nplCitations","citedByPatents","referencesDrugCore","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/PatentCoreRecord"}}},"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/patentcore/records/{amassId}":{"get":{"operationId":"getPatentCoreRecordByAmassId","tags":["cores/patentcore"],"summary":"Get record","description":"Get PatentCore record by Amass ID (preview)","parameters":[{"schema":{"type":"string","example":"AMPC_..."},"required":true,"name":"amassId","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["claims","description","nplCitations","citedByPatents","referencesDrugCore","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/PatentCoreRecord"}},"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/patentcore/records/lookup":{"post":{"operationId":"lookupPatentCoreRecords","tags":["cores/patentcore"],"summary":"Lookup","description":"Lookup PatentCore records by publication number, application number, or family id (preview). Application number and family id can each resolve to several member publications, so those items may return multiple Amass IDs.","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":{"publicationNumber":{"type":"string"}},"required":["publicationNumber"],"additionalProperties":false},{"type":"object","properties":{"applicationNumber":{"type":"string"}},"required":["applicationNumber"],"additionalProperties":false},{"type":"object","properties":{"familyId":{"type":"string"}},"required":["familyId"],"additionalProperties":false}],"description":"Look up patents by one of: publication number (one record), application number, or family id (both may resolve to several member publications)."}}},"required":["items"],"example":{"items":[{"publicationNumber":"US-10266485-B2"},{"applicationNumber":"US-15-123456"},{"familyId":"12345678"}]}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"publicationNumber":{"type":"string"}},"required":["publicationNumber"],"additionalProperties":false},{"type":"object","properties":{"applicationNumber":{"type":"string"}},"required":["applicationNumber"],"additionalProperties":false},{"type":"object","properties":{"familyId":{"type":"string"}},"required":["familyId"],"additionalProperties":false}],"description":"Look up patents by one of: publication number (one record), application number, or family id (both may resolve to several member publications)."},"amassIds":{"type":"array","items":{"type":"string","example":"AMPC_..."}},"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":{}}