{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"shortage.schema.json","title":"Medicine shortage (US FDA, EMA, AIFA, AEMPS, ANSM, BASG)","description":"Sources: US FDA drug shortages via openFDA (CC0 1.0); European Medicines Agency shortages JSON data file (reuse with acknowledgement under the EMA legal notice). Spanish AEMPS supply problems via the CIMA REST API (reproduction authorised with source and date of last update); French ANSM medicine availability list (reuse under articles L. 321-1 and following of the CRPA, source and date of last update cited); Austrian BASG register of distribution restrictions XML file (reproduction with the source cited, content not altered). Factual fields only; no contact details.","type":"object","required":["id","country","authority","status","therapeutic_areas","url","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"FDA- plus the package NDC and status, EMA- plus the EMA shortage page slug, AIFA- plus the AIC code, AEMPS- plus the Spanish national code (CN), or ANSM- plus the ANSM list item number"},"country":{"enum":["US","EU","IT","ES","FR","AT"],"description":"ISO 3166-1 alpha-2 code of the regulator's country, or EU for EMA (European Union level)"},"authority":{"type":"string","description":"Regulator that published the shortage"},"product":{"type":["string","null"],"description":"Medicine or product name as published (brand or generic name)"},"active_substance":{"type":["string","null"],"description":"Active substance, generic name or INN as published"},"strength":{"type":["string","null"],"description":"Strength affected, where published separately (FDA, EMA)"},"form":{"type":["string","null"],"description":"Dosage or pharmaceutical form affected, where published separately (FDA, EMA)"},"presentation":{"type":["string","null"],"description":"Full presentation or pack as published (FDA presentation, AIFA form, strength and pack in Italian, AEMPS full medicine name and pack in Spanish)"},"product_code":{"type":["string","null"],"description":"National product code: NDC (US package code), AIC (Italian marketing authorisation code) or CN (Spanish national code)"},"holder":{"type":["string","null"],"description":"Manufacturer or marketing authorisation holder (companies only); not published in the EMA file"},"status":{"enum":["current","anticipated","resolved","discontinued"],"description":"Normalised status: current shortage, anticipated (start date in the future), resolved, or discontinued (permanent discontinuation notified to the regulator)"},"status_published":{"type":["string","null"],"description":"Status as published by the regulator, for example Current, To Be Discontinued, Shortage ongoing"},"availability":{"type":["string","null"],"description":"FDA: Available, Limited Availability or Unavailable"},"start_date":{"type":["string","null"],"format":"date","description":"Start of the shortage as published; FDA: date first posted; EMA: start date or first publication"},"expected_resolution":{"type":["string","null"],"description":"Expected resolution as published in text, for example March 2027 or TBD"},"expected_resolution_date":{"type":["string","null"],"format":"date","description":"Expected resolution date where published as a date (EMA, AIFA, AEMPS end date, ANSM expected return to supply)"},"resolved_date":{"type":["string","null"],"format":"date","description":"FDA: date the shortage was marked resolved; ANSM: date of return to supply"},"discontinued_date":{"type":["string","null"],"format":"date","description":"FDA: date the product is or was discontinued"},"reason":{"type":["string","null"],"description":"Reason for the shortage as published (AIFA reasons translated into English where known)"},"therapeutic_areas":{"type":"array","items":{"type":"string"},"description":"FDA therapeutic categories, EMA MeSH therapeutic areas or ANSM medical domains (in French); empty when not published"},"atc_code":{"type":["string","null"],"description":"AIFA: ATC code"},"alternatives_available":{"type":["string","null"],"description":"Whether alternatives or equivalents are available, as published (EMA, AIFA); AEMPS: Yes where the published advice states that another medicine with the same active substance or a non-prescription alternative exists"},"import_authorised":{"type":"boolean","description":"AIFA: import of an equivalent medicine from abroad is authorised; AEMPS: the medicine can be requested as a foreign medicine"},"advice":{"type":["string","null"],"description":"AEMPS: the regulator's published observation on the supply problem in Spanish, for example whether other medicines exist or controlled distribution applies; BASG: the regulator's published note (Hinweis BASG) in German"},"export_ban":{"type":"boolean","description":"BASG: a parallel export ban (Parallelexportverbot) applies to the package"},"updated":{"type":["string","null"],"format":"date","description":"Date of the latest update by the regulator (AIFA: date of the list; AEMPS: date of retrieval, as the API lists active problems only)"},"language":{"enum":["en","it","es","fr","de"],"description":"Language of the published text fields"},"url":{"type":"string","description":"Official page or API record of the shortage"},"verification":{"const":"official-publication","description":"Copied from the regulator's own official publication"},"paid_placement":{"const":false,"description":"Always false: no record is paid for or promoted"},"source_id":{"enum":["openfda-drug-shortages","ema-shortages-json","aifa-farmaci-carenti","aemps-cima-psuministro","ansm-disponibilite-medicaments","basg-vertriebseinschraenkungen"]},"source_url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}}}