{"openapi":"3.1.0","info":{"title":"PlasticDB API — public read API","description":"The anonymous, read-only part of the PlasticDB REST API: every `GET` under `/api/v1/` that needs no account. Admin, curation, ingestion, account and site-internal routes are left out; the complete reference is `/openapi.json`. Cross-origin browser reads are allowed (`Access-Control-Allow-Origin: *`, no credentials). PlasticDB REST API — search plastic-degrading microorganisms & enzymes, submit bioinformatics analysis jobs, and contribute data. The data are licensed under CC BY 4.0 — see /license for how to cite.","termsOfService":"https://v2.plasticdb.org/terms","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"version":"2.90.0"},"components":{"schemas":{"Aerobicity":{"type":"string","enum":["aerobic","anaerobic","microaerophilic","not_reported"],"title":"Aerobicity","description":"Assay oxygen conditions; ``not_reported`` also matches NULL."},"AutocompleteItem":{"properties":{"id":{"type":"integer","title":"Id"},"route_key":{"type":"string","title":"Route Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"detail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail Url"}},"type":"object","required":["id","route_key"],"title":"AutocompleteItem"},"AutocompleteResult":{"properties":{"microorganisms":{"items":{"$ref":"#/components/schemas/AutocompleteItem"},"type":"array","title":"Microorganisms"},"proteins":{"items":{"$ref":"#/components/schemas/AutocompleteItem"},"type":"array","title":"Proteins"},"plastics":{"items":{"$ref":"#/components/schemas/AutocompleteItem"},"type":"array","title":"Plastics"},"papers":{"items":{"$ref":"#/components/schemas/AutocompleteItem"},"type":"array","title":"Papers"}},"type":"object","required":["microorganisms","proteins","plastics","papers"],"title":"AutocompleteResult"},"BindingAssayList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BindingAssayRead"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","offset","limit"],"title":"BindingAssayList"},"BindingAssayRead":{"properties":{"id":{"type":"integer","title":"Id"},"experiment_id":{"type":"integer","title":"Experiment Id"},"plastic_id":{"type":"integer","title":"Plastic Id"},"assay_role":{"type":"string","title":"Assay Role"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"evidence_kind":{"type":"string","enum":["binding"],"const":"binding","title":"Evidence Kind","default":"binding"},"protein_id":{"type":"integer","title":"Protein Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"paper":{"type":"object","title":"Paper"},"substrate":{"type":"object","title":"Substrate"},"experiment":{"type":"object","title":"Experiment"},"measurements":{"items":{"$ref":"#/components/schemas/BindingMeasurementRead"},"type":"array","title":"Measurements"},"preparations":{"items":{"type":"object"},"type":"array","title":"Preparations"}},"type":"object","required":["id","experiment_id","plastic_id","assay_role","notes","protein_id","protein_variant_id","paper","substrate","experiment","measurements","preparations"],"title":"BindingAssayRead"},"BindingMeasurementRead":{"properties":{"id":{"type":"integer","title":"Id"},"binding_assay_id":{"type":"integer","title":"Binding Assay Id"},"kind":{"type":"string","title":"Kind"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"sd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sd"},"n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N"},"text_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Description"},"qualifier":{"type":"string","title":"Qualifier"},"source_locator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Locator"}},"type":"object","required":["id","binding_assay_id","kind","value","unit","sd","n","text_description","qualifier","source_locator"],"title":"BindingMeasurementRead"},"ChangeItem":{"properties":{"entity_type":{"type":"string","enum":["protein","protein_variant","microorganism","plastic","paper"],"title":"Entity Type"},"id":{"type":"integer","title":"Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"status":{"type":"string","enum":["updated","removed","merged"],"title":"Status"},"merged_into":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merged Into"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["entity_type","id","status","updated_at"],"title":"ChangeItem"},"ChangesFeed":{"properties":{"since":{"type":"string","format":"date-time","title":"Since"},"as_of":{"type":"string","format":"date-time","title":"As Of"},"release":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release"},"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/ChangeItem"},"type":"array","title":"Items"}},"type":"object","required":["since","as_of","total","items"],"title":"ChangesFeed","description":"``GET /changes``. Documentation only: the endpoint returns a plain dict."},"ChemicalReferenceRead":{"properties":{"pubchem_cid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pubchem Cid"},"chebi_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chebi Id"},"inchikey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inchikey"},"backbone_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backbone Class"},"polymer_family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Polymer Family"},"identifier_status":{"type":"string","title":"Identifier Status","default":"unverified"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"monomers":{"items":{"$ref":"#/components/schemas/ReferenceMonomerRead"},"type":"array","title":"Monomers","default":[]}},"type":"object","title":"ChemicalReferenceRead","description":"Reviewed external identifiers and classification for one plastic or compound."},"CodedCount":{"properties":{"code":{"type":"string","title":"Code"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["code","count"],"title":"CodedCount"},"CompoundDetail":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formula"},"smiles":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smiles"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_additive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Additive"},"monomer_in_plastics":{"items":{"$ref":"#/components/schemas/app__schemas__compounds__PlasticRef"},"type":"array","title":"Monomer In Plastics","default":[]},"additive_in_plastics":{"items":{"$ref":"#/components/schemas/app__schemas__compounds__PlasticRef"},"type":"array","title":"Additive In Plastics","default":[]},"reaction_steps":{"items":{"$ref":"#/components/schemas/PathwayStepRef"},"type":"array","title":"Reaction Steps","default":[]},"chemical_reference":{"anyOf":[{"$ref":"#/components/schemas/ChemicalReferenceRead"},{"type":"null"}]},"reference_monomer_of":{"items":{"$ref":"#/components/schemas/app__schemas__compounds__PlasticRef"},"type":"array","title":"Reference Monomer Of","default":[]}},"type":"object","required":["id","name"],"title":"CompoundDetail","description":"Full compound detail including all entity associations."},"CompoundRead":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formula"},"smiles":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smiles"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_additive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Additive"}},"type":"object","required":["id","name"],"title":"CompoundRead"},"CompoundRef":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"CompoundRef"},"ConstructPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProteinConstructRow"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","offset","limit"],"title":"ConstructPage"},"ConstructStructureLink":{"properties":{"evidence_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Location"},"evidence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Text"},"certainty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Certainty"},"id":{"type":"integer","title":"Id"},"structure_id":{"type":"integer","title":"Structure Id"},"construct_id":{"type":"integer","title":"Construct Id"},"chain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chain Id"},"coordinate_mapping":{"anyOf":[{"type":"object"},{"items":{},"type":"array"},{"type":"null"}],"title":"Coordinate Mapping"}},"type":"object","required":["id","structure_id","construct_id"],"title":"ConstructStructureLink"},"ConstructStructureList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ConstructStructureLink"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"ConstructStructureList"},"CountryCount":{"properties":{"country":{"type":"string","title":"Country"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["country","count"],"title":"CountryCount"},"CuratedReactionStep":{"properties":{"step_id":{"type":"integer","title":"Step Id"},"step_order":{"type":"integer","title":"Step Order"},"ec_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ec Number"},"step_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Type"},"pathway_id":{"type":"integer","title":"Pathway Id"},"pathway_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pathway Name"},"plastic":{"anyOf":[{"$ref":"#/components/schemas/ProductPlasticRef"},{"type":"null"}]},"substrate":{"$ref":"#/components/schemas/CompoundRef"},"product":{"$ref":"#/components/schemas/CompoundRef"}},"type":"object","required":["step_id","step_order","pathway_id","substrate","product"],"title":"CuratedReactionStep","description":"One curated ``ReactionStep`` the enzyme catalyses."},"CurrentReleaseResponse":{"properties":{"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"released_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Released At"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"},"snapshot_release_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Release Label"},"citation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citation"},"license":{"type":"string","title":"License","description":"The data licence, e.g. 'CC BY 4.0'.","default":"CC BY 4.0"},"license_spdx":{"type":"string","title":"License Spdx","description":"SPDX identifier.","default":"CC-BY-4.0"},"license_url":{"type":"string","title":"License Url","default":"https://creativecommons.org/licenses/by/4.0/"},"paper_citation":{"type":"string","title":"Paper Citation","default":"Gambarini V, Pantos O, Kingsbury JM, Weaver L, Handley KM, Lear G (2022). PlasticDB: a database of microorganisms and proteins linked to plastic biodegradation. Database, 2022:baac008."},"paper_doi":{"type":"string","title":"Paper Doi","default":"10.1093/database/baac008"}},"type":"object","title":"CurrentReleaseResponse","description":"What a user needs in order to say which database they used."},"DatasetReleaseRead":{"properties":{"version":{"type":"string","title":"Version","description":"ISO year and week, e.g. '2026.35'. Distinct from the application version: this names the DATA you aligned against."},"released_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Released At","description":"When the release completed (UTC)."},"promoted_proteins":{"type":"integer","title":"Promoted Proteins","description":"Proteins this release made public (previously staged)."},"promoted_microorganisms":{"type":"integer","title":"Promoted Microorganisms","description":"Microorganisms this release made public (previously staged)."},"entity_counts":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Entity Counts","description":"Row counts of the archived snapshot this release cut, per entity; null when the release cut no snapshot of its own."},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi","description":"DOI of this release's published archive, if one was minted."},"artefacts":{"anyOf":[{"$ref":"#/components/schemas/ReleaseArtefacts"},{"type":"null"}],"description":"The release's immutable, checksummed files (Parquet tables, DIAMOND databases, profile library) and the tool versions that built them. Only on GET /releases/{version}; null when the release has none."}},"type":"object","required":["version","promoted_proteins","promoted_microorganisms"],"title":"DatasetReleaseRead","description":"One weekly cut of the public dataset — what a reader may cite."},"DegradationLink":{"properties":{"plastic":{"$ref":"#/components/schemas/app__schemas__entities__PlasticRef"},"result":{"type":"string","title":"Result"},"methods":{"items":{"type":"string"},"type":"array","title":"Methods","default":[]},"positive_count":{"type":"integer","title":"Positive Count","default":0},"inconclusive_count":{"type":"integer","title":"Inconclusive Count","default":0},"negative_count":{"type":"integer","title":"Negative Count","default":0},"positive_papers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Positive Papers"},"inconclusive_papers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inconclusive Papers"},"negative_papers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Negative Papers"},"paper_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Count"},"result_polarity":{"type":"string","title":"Result Polarity","description":"Bucket label for the pairing: ``positive``/``inconclusive``/``negative`` when the\nsupporting papers agree, else ``mixed``.","readOnly":true}},"type":"object","required":["plastic","result","result_polarity"],"title":"DegradationLink","description":"Backward-compatible flattened shape: one row per (actor, plastic) with the best result\npolarity and the union of experiment methods."},"EngineeringLineage":{"properties":{"id":{"type":"integer","title":"Id"},"plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"variants":{"items":{"$ref":"#/components/schemas/ProteinVariantRead"},"type":"array","title":"Variants","default":[]},"wild_type_kinetics":{"items":{"$ref":"#/components/schemas/EnzymeKineticsRead"},"type":"array","title":"Wild Type Kinetics","default":[]},"wild_type_properties":{"items":{"$ref":"#/components/schemas/EnzymePropertiesRead"},"type":"array","title":"Wild Type Properties","default":[]}},"type":"object","required":["id","plasticdb_id","name"],"title":"EngineeringLineage","description":"Parent protein summary with full variant lineage, shaped for the comparison UI."},"EnvironmentCount":{"properties":{"environment":{"type":"string","title":"Environment"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["environment","count"],"title":"EnvironmentCount"},"EnvironmentType":{"type":"string","enum":["activated_sludge","coastal","compost","deep_sea","freshwater","gut","hot_spring","industrial","landfill","mangrove","marine_sediment","marine_water","other","plant_material","plastic_surface","rhizosphere","soil","wastewater"],"title":"EnvironmentType"},"EnzymeKineticsRead":{"properties":{"substrate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate"},"substrate_plastic_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Plastic Id"},"substrate_compound_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Compound Id"},"id":{"type":"integer","title":"Id"},"protein_id":{"type":"integer","title":"Protein Id"},"plastic_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"experiment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Experiment Id"},"km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Km"},"kcat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Kcat"},"vmax":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vmax"},"km_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Km Unit"},"kcat_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kcat Unit"},"vmax_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vmax Unit"},"experiment":{"anyOf":[{"$ref":"#/components/schemas/ExperimentConditionsRef"},{"type":"null"}]},"plastic":{"anyOf":[{"$ref":"#/components/schemas/PlasticRead"},{"type":"null"}]},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"protein_variant":{"anyOf":[{"$ref":"#/components/schemas/ProteinVariantRef"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"substrate_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Kind","description":"``plastic`` | ``compound`` — which vocabulary the substrate resolved in.","readOnly":true},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","description":"Assay temperature, read from the linked experiment.","readOnly":true},"ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ph","description":"Assay pH, read from the linked experiment.","readOnly":true},"substrate_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Form","description":"Substrate form, read from the linked experiment.","readOnly":true},"kcat_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Kcat Km","description":"Catalytic efficiency (kcat/Km) in M⁻¹·s⁻¹, derived when computable.","readOnly":true},"kcat_km_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kcat Km Unit","readOnly":true},"kcat_normalised":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Kcat Normalised","description":"kcat in s⁻¹ (``kcat_normalised_unit``), or ``None`` if not convertible.","readOnly":true},"kcat_normalised_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kcat Normalised Unit","readOnly":true},"km_normalised":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Km Normalised","description":"Km in mM (``km_normalised_unit``), or ``None`` if not molar.","readOnly":true},"km_normalised_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Km Normalised Unit","readOnly":true},"kcat_km_normalised":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Kcat Km Normalised","description":"kcat/Km in M⁻¹·s⁻¹ — the same value as ``kcat_km``, named to match.","readOnly":true}},"type":"object","required":["id","protein_id","created_at","updated_at","substrate_kind","temperature","ph","substrate_form","kcat_km","kcat_km_unit","kcat_normalised","kcat_normalised_unit","km_normalised","km_normalised_unit","kcat_km_normalised"],"title":"EnzymeKineticsRead"},"EnzymePreparationDetail":{"properties":{"evidence_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Location"},"evidence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Text"},"certainty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Certainty"},"id":{"type":"integer","title":"Id"},"protein_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Scope"},"local_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Local Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"provenance":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Provenance"},"construct_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Construct Id"},"expression_host":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expression Host"},"purification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purification"},"tag_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Status"},"modifications":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Modifications"},"supplier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier"},"product":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product"},"lot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lot"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"experiments":{"items":{"$ref":"#/components/schemas/ExperimentPreparationLink"},"type":"array","title":"Experiments","default":[]}},"type":"object","required":["id"],"title":"EnzymePreparationDetail"},"EnzymePreparationRow":{"properties":{"evidence_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Location"},"evidence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Text"},"certainty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Certainty"},"id":{"type":"integer","title":"Id"},"protein_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Scope"},"local_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Local Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"provenance":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Provenance"},"construct_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Construct Id"},"expression_host":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expression Host"},"purification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purification"},"tag_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Status"},"modifications":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Modifications"},"supplier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier"},"product":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product"},"lot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lot"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["id"],"title":"EnzymePreparationRow"},"EnzymePropertiesRead":{"properties":{"substrate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate"},"substrate_plastic_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Plastic Id"},"substrate_compound_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Compound Id"},"id":{"type":"integer","title":"Id"},"protein_id":{"type":"integer","title":"Protein Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"experiment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Experiment Id"},"specific_activity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Specific Activity"},"specific_activity_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specific Activity Unit"},"optimal_temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Optimal Temperature"},"optimal_ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Optimal Ph"},"tm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tm"},"t50":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"T50"},"half_life":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Half Life"},"half_life_temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Half Life Temperature"},"assay_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Notes"},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"protein_variant":{"anyOf":[{"$ref":"#/components/schemas/ProteinVariantRef"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"substrate_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Kind","description":"``plastic`` | ``compound`` — which vocabulary the substrate resolved in.","readOnly":true}},"type":"object","required":["id","protein_id","created_at","updated_at","substrate_kind"],"title":"EnzymePropertiesRead"},"EvidenceList_ExperimentRecord_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/ExperimentRecord"},"type":"array","title":"Items"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["total","items","offset","limit"],"title":"EvidenceList[ExperimentRecord]"},"EvidenceList_InteractionRecord_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/InteractionRecord"},"type":"array","title":"Items"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["total","items","offset","limit"],"title":"EvidenceList[InteractionRecord]"},"EvidenceList_ObservationRecord_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/ObservationRecord"},"type":"array","title":"Items"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["total","items","offset","limit"],"title":"EvidenceList[ObservationRecord]"},"EvidenceMethod":{"type":"string","enum":["adsorption_isotherm","afm","biosensor","cd","chn_analysis","clear_zone","clsm","co2_evolution","cod","contact_angle","dcpip","dls","dsc","eds","enzyme_assay","fcm","fluorescent_assay","frap","ftir","gc","gc_ms","gpc_sec","growth_on_plastic","hplc","lc_ms","luminescence","maldi_tof","mass_remaining","ms","nmr","o2_consumption","optical_microscopy","qcm","radiolabeling","raman","ros_assay","sem","ssa","tem","tensile_strength","tga","tirf","titration","tlc","toc","turbidity","uv_vis","viscometry","visual_inspection","weight_loss","xps","xrd","zymogram"],"title":"EvidenceMethod"},"EvidenceScope":{"type":"string","enum":["organism_or_enzyme","whole_organism","enzyme_only"],"title":"EvidenceScope","description":"``evidence_scope`` where it selects entities (or a single record's rows)."},"ExperimentConditionsRef":{"properties":{"assay_result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result"},"assay_result_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result Notes"},"detection_limit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Detection Limit"},"detection_limit_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detection Limit Unit"},"quantitation_ceiling":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantitation Ceiling"},"quantitation_ceiling_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantitation Ceiling Unit"},"id":{"type":"integer","title":"Id"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"},"temperature_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Temperature Unit"},"ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ph"},"substrate_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Form"},"buffer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buffer"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"},"duration_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration Unit"}},"type":"object","required":["id"],"title":"ExperimentConditionsRef","description":"Assay conditions embedded in kinetics rows."},"ExperimentPreparationLink":{"properties":{"experiment_id":{"type":"integer","title":"Experiment Id"},"preparation_id":{"type":"integer","title":"Preparation Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"}},"type":"object","required":["experiment_id","preparation_id"],"title":"ExperimentPreparationLink"},"ExperimentPreparationList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ExperimentPreparationLink"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"ExperimentPreparationList"},"ExperimentRead":{"properties":{"id":{"type":"integer","title":"Id"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"},"temperature_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Temperature Unit"},"ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ph"},"buffer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buffer"},"duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"},"duration_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration Unit"},"substrate_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Form"},"sole_carbon_source":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Sole Carbon Source"},"culture_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Culture Medium"},"aerobicity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aerobicity"},"substrate_crystallinity_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Substrate Crystallinity Pct"},"substrate_mw":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Substrate Mw"},"substrate_mw_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Mw Unit"},"analytical_grade":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Analytical Grade"},"assay_result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result"},"assay_result_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result Notes"},"detection_limit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Detection Limit"},"detection_limit_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detection Limit Unit"},"quantitation_ceiling":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantitation Ceiling"},"quantitation_ceiling_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantitation Ceiling Unit"},"initial_mass":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Initial Mass"},"initial_mass_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initial Mass Unit"},"observations":{"items":{"$ref":"#/components/schemas/ObservationRead"},"type":"array","title":"Observations","default":[]}},"type":"object","required":["id"],"title":"ExperimentRead"},"ExperimentRecord":{"properties":{"id":{"type":"integer","title":"Id"},"interaction_id":{"type":"integer","title":"Interaction Id"},"paper_id":{"type":"integer","title":"Paper Id"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method"},"method_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method Category"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"},"temperature_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Temperature Unit"},"ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ph"},"buffer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buffer"},"duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"},"duration_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration Unit"},"substrate_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Form"},"sole_carbon_source":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Sole Carbon Source"},"culture_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Culture Medium"},"aerobicity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aerobicity"},"substrate_crystallinity_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Substrate Crystallinity Pct"},"substrate_mw":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Substrate Mw"},"substrate_mw_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Mw Unit"},"analytical_grade":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Analytical Grade"},"detection_limit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Detection Limit"},"detection_limit_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detection Limit Unit"},"quantitation_ceiling":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantitation Ceiling"},"quantitation_ceiling_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantitation Ceiling Unit"},"initial_mass":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Initial Mass"},"initial_mass_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initial Mass Unit"},"assay_result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result"},"assay_result_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result Notes"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"additional_conditions":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Additional Conditions"}},"type":"object","required":["id","interaction_id","paper_id"],"title":"ExperimentRecord"},"FootprintExperimentRead":{"properties":{"id":{"type":"integer","title":"Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method"},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature"},"temperature_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Temperature Unit"},"ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ph"},"buffer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buffer"},"duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"},"duration_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration Unit"},"substrate_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Form"},"sole_carbon_source":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Sole Carbon Source"},"culture_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Culture Medium"},"aerobicity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aerobicity"},"substrate_crystallinity_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Substrate Crystallinity Pct"},"substrate_mw":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Substrate Mw"},"substrate_mw_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Mw Unit"},"analytical_grade":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Analytical Grade"},"assay_result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result"},"assay_result_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Result Notes"},"detection_limit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Detection Limit"},"detection_limit_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detection Limit Unit"},"quantitation_ceiling":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantitation Ceiling"},"quantitation_ceiling_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantitation Ceiling Unit"},"initial_mass":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Initial Mass"},"initial_mass_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initial Mass Unit"},"observations":{"items":{"$ref":"#/components/schemas/FootprintObservationRead"},"type":"array","title":"Observations","default":[]}},"type":"object","required":["id"],"title":"FootprintExperimentRead"},"FootprintInteractionRead":{"properties":{"id":{"type":"integer","title":"Id"},"paper_id":{"type":"integer","title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_superseded":{"type":"boolean","title":"Source Superseded","default":false},"plastic":{"$ref":"#/components/schemas/app__schemas__entities__PlasticRef"},"actor_type":{"type":"string","title":"Actor Type"},"result":{"type":"string","title":"Result"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"protein_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"strain_occurrence_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Strain Occurrence Id"},"microorganism_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Microorganism Id"},"strain_designation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strain Designation"},"genetic_background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genetic Background"},"experiments":{"items":{"$ref":"#/components/schemas/FootprintExperimentRead"},"type":"array","title":"Experiments","default":[]}},"type":"object","required":["id","paper_id","plastic","actor_type","result"],"title":"FootprintInteractionRead","description":"One interaction with its experiments, and **which actor it hangs off**."},"FootprintKineticsRead":{"properties":{"substrate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate"},"substrate_plastic_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Plastic Id"},"substrate_compound_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Compound Id"},"id":{"type":"integer","title":"Id"},"protein_id":{"type":"integer","title":"Protein Id"},"plastic_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_superseded":{"type":"boolean","title":"Source Superseded","default":false},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"experiment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Experiment Id"},"km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Km"},"kcat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Kcat"},"vmax":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vmax"},"km_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Km Unit"},"kcat_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kcat Unit"},"vmax_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vmax Unit"},"experiment":{"anyOf":[{"$ref":"#/components/schemas/ExperimentConditionsRef"},{"type":"null"}]},"plastic":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__entities__PlasticRef"},{"type":"null"}]},"protein_variant":{"anyOf":[{"$ref":"#/components/schemas/FootprintVariantRef"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"substrate_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Kind","description":"``plastic`` | ``compound`` — which vocabulary the substrate resolved in.","readOnly":true},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","description":"Assay temperature, read from the linked experiment.","readOnly":true},"ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ph","description":"Assay pH, read from the linked experiment.","readOnly":true},"substrate_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Form","description":"Substrate form, read from the linked experiment.","readOnly":true}},"type":"object","required":["id","protein_id","created_at","updated_at","substrate_kind","temperature","ph","substrate_form"],"title":"FootprintKineticsRead"},"FootprintMicroorganismRead":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"tax_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_superseded":{"type":"boolean","title":"Source Superseded","default":false},"sample_source":{"anyOf":[{"$ref":"#/components/schemas/SampleSourceRead"},{"type":"null"}]}},"type":"object","required":["id","name"],"title":"FootprintMicroorganismRead"},"FootprintObservationRead":{"properties":{"time_point":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Time Point"},"time_point_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Point Unit"},"sd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sd"},"n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N"},"control_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Control Value"},"id":{"type":"integer","title":"Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"measurement_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measurement Type"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"text_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Description"}},"type":"object","required":["id"],"title":"FootprintObservationRead"},"FootprintPropertiesRead":{"properties":{"substrate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate"},"substrate_plastic_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Plastic Id"},"substrate_compound_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Substrate Compound Id"},"specific_activity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Specific Activity"},"specific_activity_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Specific Activity Unit"},"id":{"type":"integer","title":"Id"},"protein_id":{"type":"integer","title":"Protein Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_superseded":{"type":"boolean","title":"Source Superseded","default":false},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"experiment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Experiment Id"},"experiment":{"anyOf":[{"$ref":"#/components/schemas/ExperimentConditionsRef"},{"type":"null"}]},"optimal_temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Optimal Temperature"},"optimal_ph":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Optimal Ph"},"tm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tm"},"t50":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"T50"},"half_life":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Half Life"},"half_life_temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Half Life Temperature"},"assay_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assay Notes"},"protein_variant":{"anyOf":[{"$ref":"#/components/schemas/FootprintVariantRef"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"substrate_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Kind","description":"``plastic`` | ``compound`` — which vocabulary the substrate resolved in.","readOnly":true}},"type":"object","required":["id","protein_id","created_at","updated_at","substrate_kind"],"title":"FootprintPropertiesRead"},"FootprintProteinRead":{"properties":{"id":{"type":"integer","title":"Id"},"plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_superseded":{"type":"boolean","title":"Source Superseded","default":false},"is_tombstoned":{"type":"boolean","title":"Is Tombstoned","default":false}},"type":"object","required":["id","name"],"title":"FootprintProteinRead"},"FootprintProteinVariantRead":{"properties":{"synonyms":{"items":{"type":"string"},"type":"array","title":"Synonyms","default":[]},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"numbering_scheme_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme Code"},"numbering_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Reference"},"numbering_scheme_code_proposed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme Code Proposed"},"originating_paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Originating Paper Id"},"originating_doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Originating Doi"},"originating_paper_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Originating Paper Source"},"id":{"type":"integer","title":"Id"},"parent_protein_id":{"type":"integer","title":"Parent Protein Id"},"variant_name":{"type":"string","title":"Variant Name"},"variant_type":{"type":"string","title":"Variant Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence"},"engineering_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engineering Method"},"performance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Performance"},"numbering_scheme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme"},"numbering_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Numbering Offset"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_superseded":{"type":"boolean","title":"Source Superseded","default":false},"parent_protein_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Protein Accession"},"mutations":{"items":{"$ref":"#/components/schemas/MutationRead"},"type":"array","title":"Mutations","default":[]}},"type":"object","required":["id","parent_protein_id","variant_name","variant_type"],"title":"FootprintProteinVariantRead"},"FootprintStrainRead":{"properties":{"strain_occurrence_id":{"type":"integer","title":"Strain Occurrence Id"},"microorganism_id":{"type":"integer","title":"Microorganism Id"},"strain_designation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strain Designation"},"genetic_background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genetic Background"},"culture_collection_ids":{"items":{"type":"string"},"type":"array","title":"Culture Collection Ids","default":[]},"genome_assembly_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genome Assembly Accession"},"isolation_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Isolation Source"},"sample_source":{"anyOf":[{"$ref":"#/components/schemas/SampleSourceRead"},{"type":"null"}]}},"type":"object","required":["strain_occurrence_id","microorganism_id"],"title":"FootprintStrainRead"},"FootprintVariantRef":{"properties":{"id":{"type":"integer","title":"Id"},"variant_name":{"type":"string","title":"Variant Name"}},"type":"object","required":["id","variant_name"],"title":"FootprintVariantRef","description":"Minimal variant ref for kinetics/properties rows in the paper footprint."},"GenomeComparison":{"properties":{"blast_type":{"type":"string","title":"Blast Type"},"counted":{"type":"string","title":"Counted"},"normalisation":{"$ref":"#/components/schemas/GenomeComparisonUnit"},"normalised":{"type":"boolean","title":"Normalised","default":false},"plastics":{"items":{"type":"string"},"type":"array","title":"Plastics","default":[]},"genomes":{"items":{"$ref":"#/components/schemas/GenomeComparisonRow"},"type":"array","title":"Genomes","default":[]}},"type":"object","required":["blast_type","counted","normalisation"],"title":"GenomeComparison","description":"The genome × plastic matrix for a compare_genomes job (B7, R10-1)."},"GenomeComparisonRow":{"properties":{"label":{"type":"string","title":"Label"},"sequences":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sequences"},"residues":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Residues"},"hits":{"type":"integer","title":"Hits","default":0},"positive":{"type":"integer","title":"Positive","default":0},"not_positive":{"type":"integer","title":"Not Positive","default":0},"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts","default":{}},"normalised":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Normalised"},"positive_normalised":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Positive Normalised"}},"type":"object","required":["label"],"title":"GenomeComparisonRow","description":"One genome's row of the Compare Genomes matrix."},"GenomeComparisonUnit":{"properties":{"key":{"type":"string","enum":["per_1000_proteins","per_mb"],"title":"Key"},"label":{"type":"string","title":"Label"},"denominator":{"type":"string","title":"Denominator"}},"type":"object","required":["key","label","denominator"],"title":"GenomeComparisonUnit"},"GlobalSearchResult":{"properties":{"id":{"type":"integer","title":"Id"},"route_key":{"type":"string","title":"Route Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"entity_type":{"type":"string","title":"Entity Type"},"rank":{"type":"number","title":"Rank"},"extra":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extra"},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match"},"detail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail Url"}},"type":"object","required":["id","route_key","entity_type","rank"],"title":"GlobalSearchResult"},"GroupedSearch":{"properties":{"total":{"type":"integer","title":"Total"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"groups":{"additionalProperties":{"$ref":"#/components/schemas/SearchGroup"},"type":"object","title":"Groups"},"plastic_matches":{"items":{"$ref":"#/components/schemas/PlasticShortcut"},"type":"array","title":"Plastic Matches"},"suggestion":{"anyOf":[{"$ref":"#/components/schemas/SearchSuggestion"},{"type":"null"}]}},"type":"object","required":["total","groups","plastic_matches"],"title":"GroupedSearch"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HitEvidence":{"properties":{"plastic":{"type":"string","title":"Plastic"},"positive":{"type":"integer","title":"Positive","default":0},"negative":{"type":"integer","title":"Negative","default":0},"inconclusive":{"type":"integer","title":"Inconclusive","default":0}},"type":"object","required":["plastic"],"title":"HitEvidence","description":"One plastic the hit record has its **own** evidence for, by result."},"IdentitySourcePublic":{"properties":{"source":{"type":"string","title":"Source"},"label":{"type":"string","title":"Label"},"fields":{"items":{"type":"string"},"type":"array","title":"Fields","default":[]}},"type":"object","required":["source","label"],"title":"IdentitySourcePublic","description":"The public face of an identity value's origin: its *type* only."},"IngestionLineageEntry":{"properties":{"id":{"type":"integer","title":"Id"},"extraction_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Model"},"extraction_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Extraction Version"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"supersedes_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Supersedes Id"},"is_current":{"type":"boolean","title":"Is Current","default":false},"is_superseded":{"type":"boolean","title":"Is Superseded","default":false}},"type":"object","required":["id"],"title":"IngestionLineageEntry","description":"One approved extraction of a paper, ordered oldest → newest."},"InteractionRead":{"properties":{"id":{"type":"integer","title":"Id"},"plastic":{"$ref":"#/components/schemas/app__schemas__entities__PlasticRef"},"actor_type":{"type":"string","title":"Actor Type"},"result":{"type":"string","title":"Result"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"strain_occurrence":{"anyOf":[{"$ref":"#/components/schemas/StrainOccurrenceRef"},{"type":"null"}]},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"experiments":{"items":{"$ref":"#/components/schemas/ExperimentRead"},"type":"array","title":"Experiments","default":[]},"indirect_source_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indirect Source Label"},"indirect_source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indirect Source Url"},"expression_hosts":{"items":{"type":"string"},"type":"array","title":"Expression Hosts","default":[]},"strain_designation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strain Designation","description":"Back-compat flat field: the strain as reported for this interaction.","readOnly":true}},"type":"object","required":["id","plastic","actor_type","result","strain_designation"],"title":"InteractionRead"},"InteractionRecord":{"properties":{"id":{"type":"integer","title":"Id"},"paper_id":{"type":"integer","title":"Paper Id"},"plastic_id":{"type":"integer","title":"Plastic Id"},"actor_type":{"type":"string","enum":["microorganism","protein","protein_variant"],"title":"Actor Type"},"result":{"type":"string","enum":["positive","negative","inconclusive"],"title":"Result"},"strain_occurrence_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Strain Occurrence Id"},"microorganism_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Microorganism Id","description":"The tested organism (whole-organism evidence only)."},"microorganism_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Microorganism Accession"},"protein_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"},"protein_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protein Accession"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"protein_variant_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protein Variant Accession"},"credited_microorganism_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credited Microorganism Id","description":"The organism this evidence credits under the default `organism_or_enzyme` scope: the tested organism (not an expression host, knockout or engineered host), or an enzyme's public source organism."},"experimental_system":{"type":"string","title":"Experimental System"},"enzyme_production_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enzyme Production Context"},"enzyme_preparation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enzyme Preparation"},"strain_designation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strain Designation"},"genetic_background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genetic Background"}},"type":"object","required":["id","paper_id","plastic_id","actor_type","result","experimental_system"],"title":"InteractionRecord"},"JobDetail":{"properties":{"id":{"type":"string","title":"Id"},"job_type":{"type":"string","title":"Job Type"},"status":{"type":"string","title":"Status"},"evalue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Evalue"},"pident":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pident"},"organism_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organism Type"},"blast_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blast Type"},"include_variants":{"type":"boolean","title":"Include Variants","default":false},"genus_column":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Genus Column"},"species_column":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Species Column"},"field_separator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field Separator"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"result_count":{"type":"integer","title":"Result Count","default":0},"result_newick":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Newick"},"result_metadata":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Result Metadata"},"has_result_file":{"type":"boolean","title":"Has Result File","default":false},"view_defaults":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"View Defaults"},"runtime_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Runtime Seconds"},"input_filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Filename"},"parameters_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parameters Summary"},"result_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Summary"},"results_expire_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Results Expire At"},"results_expired_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Results Expired At"},"release":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release"},"release_source":{"anyOf":[{"type":"string","enum":["snapshot","live"]},{"type":"null"}],"title":"Release Source"},"reference_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Sha256"},"tool_versions":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Tool Versions"},"results":{"items":{"$ref":"#/components/schemas/JobResultItem"},"type":"array","title":"Results","default":[]},"comparison":{"anyOf":[{"$ref":"#/components/schemas/GenomeComparison"},{"type":"null"}]}},"type":"object","required":["id","job_type","status","evalue","pident","organism_type","blast_type","error_message","created_at","completed_at"],"title":"JobDetail"},"JobHitOrganism":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"tax_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"}},"type":"object","required":["id","name"],"title":"JobHitOrganism","description":"The organism a hit protein was isolated from, for a per-taxon summary."},"JobHitProtein":{"properties":{"id":{"type":"integer","title":"Id"},"plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"uniprot_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uniprot Accession"},"source_microorganism":{"anyOf":[{"$ref":"#/components/schemas/JobHitOrganism"},{"type":"null"}]},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"paper_count":{"type":"integer","title":"Paper Count","default":0}},"type":"object","required":["id","name"],"title":"JobHitProtein","description":"The PlasticDB protein a hit landed on, with what a summary needs (R10-2)."},"JobRead":{"properties":{"id":{"type":"string","title":"Id"},"job_type":{"type":"string","title":"Job Type"},"status":{"type":"string","title":"Status"},"evalue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Evalue"},"pident":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pident"},"organism_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organism Type"},"blast_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blast Type"},"include_variants":{"type":"boolean","title":"Include Variants","default":false},"genus_column":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Genus Column"},"species_column":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Species Column"},"field_separator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field Separator"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"result_count":{"type":"integer","title":"Result Count","default":0},"result_newick":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Newick"},"result_metadata":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Result Metadata"},"has_result_file":{"type":"boolean","title":"Has Result File","default":false},"view_defaults":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"View Defaults"},"runtime_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Runtime Seconds"},"input_filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Filename"},"parameters_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parameters Summary"},"result_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Summary"},"results_expire_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Results Expire At"},"results_expired_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Results Expired At"},"release":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release"},"release_source":{"anyOf":[{"type":"string","enum":["snapshot","live"]},{"type":"null"}],"title":"Release Source"},"reference_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Sha256"},"tool_versions":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Tool Versions"}},"type":"object","required":["id","job_type","status","evalue","pident","organism_type","blast_type","error_message","created_at","completed_at"],"title":"JobRead"},"JobResultItem":{"properties":{"id":{"type":"integer","title":"Id"},"query_seq_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Seq Id"},"subject_seq_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Seq Id"},"pident":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pident","description":"% identity of the alignment. Null on hmm_screen hits."},"length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Length","description":"Alignment length. Null on hmm_screen hits."},"evalue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Evalue","description":"DIAMOND: the alignment's E-value. hmm_screen: the full-sequence E-value."},"bitscore":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bitscore","description":"DIAMOND: the alignment's bit score. hmm_screen: the full-sequence bit score (what the gathering cut-off is compared to)."},"qcov":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qcov","description":"% of the query the alignment spans. Null on hmm_screen hits."},"scov":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Scov","description":"% of the reference the alignment spans. Null on hmm_screen hits."},"profile_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Accession","description":"hmm_screen: the profile's ACC (subject_seq_id is its NAME); null when the profile has none."},"domain_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Domain Score","description":"hmm_screen: the best-scoring domain's bit score."},"domain_c_evalue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Domain C Evalue","description":"hmm_screen: the best domain's conditional E-value."},"domain_i_evalue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Domain I Evalue","description":"hmm_screen: the best domain's independent E-value."},"hmm_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hmm From","description":"hmm_screen: best domain start on the profile (1-based)."},"hmm_to":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hmm To","description":"hmm_screen: best domain end on the profile (inclusive)."},"env_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Env From","description":"hmm_screen: best domain envelope start on the submitted sequence (1-based)."},"env_to":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Env To","description":"hmm_screen: best domain envelope end on the submitted sequence (inclusive)."},"subject_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Accession"},"source_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Label"},"protein":{"anyOf":[{"$ref":"#/components/schemas/JobHitProtein"},{"type":"null"}]},"variant":{"anyOf":[{"$ref":"#/components/schemas/JobVariantItem"},{"type":"null"}]},"evidence":{"items":{"$ref":"#/components/schemas/HitEvidence"},"type":"array","title":"Evidence","default":[]},"evidence_polarity":{"type":"string","title":"Evidence Polarity","default":"none"},"calibration_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calibration Status"},"calibration_status_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calibration Status Reason"}},"type":"object","required":["id","query_seq_id","subject_seq_id","pident","length","evalue","bitscore","protein"],"title":"JobResultItem","description":"One hit. DIAMOND jobs fill the alignment fields; ``hmm_screen`` hits\nleave ``pident``/``length``/``qcov``/``scov`` null and fill the HMM fields\ninstead (null on HMM jobs run before 2.90.0 and on every DIAMOND hit)."},"JobVariantItem":{"properties":{"id":{"type":"integer","title":"Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"variant_name":{"type":"string","title":"Variant Name"},"variant_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Type"}},"type":"object","required":["id","variant_name"],"title":"JobVariantItem","description":"The engineered variant a hit landed on, for linking out to /variants/{id}."},"LabelCount":{"properties":{"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"LabelCount"},"LineageLevels":{"properties":{"domain":{"items":{"type":"string"},"type":"array","title":"Domain"},"kingdom":{"items":{"type":"string"},"type":"array","title":"Kingdom"},"phylum":{"items":{"type":"string"},"type":"array","title":"Phylum"},"class":{"items":{"type":"string"},"type":"array","title":"Class"},"order":{"items":{"type":"string"},"type":"array","title":"Order"},"family":{"items":{"type":"string"},"type":"array","title":"Family"},"genus":{"items":{"type":"string"},"type":"array","title":"Genus"}},"type":"object","required":["domain","kingdom","phylum","class","order","family","genus"],"title":"LineageLevels","description":"The distinct names at each rank among the (filtered) lineages."},"MicroorganismDetail":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"tax_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"taxonomy_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy Status"},"taxonomy_cause":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy Cause"},"taxonomy_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy Note"},"growth_temp_opt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Growth Temp Opt"},"oxygen_requirement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oxygen Requirement"},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"papers":{"items":{"$ref":"#/components/schemas/PaperRead"},"type":"array","title":"Papers","default":[]},"assay_temp_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Assay Temp Min"},"assay_temp_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Assay Temp Max"},"environments":{"items":{"type":"string"},"type":"array","title":"Environments","default":[]},"locations":{"items":{"type":"string"},"type":"array","title":"Locations","default":[]},"strain_designations":{"items":{"type":"string"},"type":"array","title":"Strain Designations","default":[]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"lineage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"},"synonyms":{"items":{"type":"string"},"type":"array","title":"Synonyms"},"also_known_as":{"items":{"type":"string"},"type":"array","title":"Also Known As"},"growth_temp_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Growth Temp Min"},"growth_temp_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Growth Temp Max"},"plastics":{"items":{"$ref":"#/components/schemas/PlasticRead"},"type":"array","title":"Plastics","default":[]},"interactions":{"items":{"$ref":"#/components/schemas/InteractionRead"},"type":"array","title":"Interactions","default":[]},"indirect_interactions":{"items":{"$ref":"#/components/schemas/InteractionRead"},"type":"array","title":"Indirect Interactions","default":[]},"construct_interactions":{"items":{"$ref":"#/components/schemas/InteractionRead"},"type":"array","title":"Construct Interactions","default":[]},"proteins":{"items":{"$ref":"#/components/schemas/ProteinListItem"},"type":"array","title":"Proteins","default":[]},"strain_occurrences":{"items":{"$ref":"#/components/schemas/StrainOccurrenceRead"},"type":"array","title":"Strain Occurrences","default":[]},"strains":{"items":{"$ref":"#/components/schemas/StrainSummary"},"type":"array","title":"Strains","default":[]}},"type":"object","required":["id","name","tax_id"],"title":"MicroorganismDetail"},"MicroorganismListItem":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"tax_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"taxonomy_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy Status"},"taxonomy_cause":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy Cause"},"taxonomy_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taxonomy Note"},"growth_temp_opt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Growth Temp Opt"},"oxygen_requirement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oxygen Requirement"},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"papers":{"items":{"$ref":"#/components/schemas/PaperRead"},"type":"array","title":"Papers","default":[]},"assay_temp_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Assay Temp Min"},"assay_temp_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Assay Temp Max"},"environments":{"items":{"type":"string"},"type":"array","title":"Environments","default":[]},"locations":{"items":{"type":"string"},"type":"array","title":"Locations","default":[]},"strain_designations":{"items":{"type":"string"},"type":"array","title":"Strain Designations","default":[]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","tax_id"],"title":"MicroorganismListItem"},"MicroorganismOption":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"MicroorganismOption"},"ModelInputCut":{"properties":{"kind":{"type":"string","title":"Kind"},"terminus":{"type":"string","title":"Terminus"},"start":{"type":"integer","title":"Start"},"end":{"type":"integer","title":"End"}},"type":"object","required":["kind","terminus","start","end"],"title":"ModelInputCut","description":"One terminal span the normalization policy removed (source coordinates)."},"ModelInputRead":{"properties":{"status":{"type":"string","title":"Status"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence"},"length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Length"},"span":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Span"},"source_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Length"},"whole_sequence_fallback":{"type":"boolean","title":"Whole Sequence Fallback","default":false},"cuts":{"items":{"$ref":"#/components/schemas/ModelInputCut"},"type":"array","title":"Cuts","default":[]},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons","default":[]},"blocking_reasons":{"items":{"type":"string"},"type":"array","title":"Blocking Reasons","default":[]},"policy_version":{"type":"string","title":"Policy Version"},"model_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Sha256"},"canonical_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Sha256"}},"type":"object","required":["status","policy_version"],"title":"ModelInputRead","description":"This record's model input: what sequence-based analyses read."},"MutationRead":{"properties":{"id":{"type":"integer","title":"Id"},"protein_variant_id":{"type":"integer","title":"Protein Variant Id"},"wild_type_residue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wild Type Residue"},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position"},"mutant_residue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mutant Residue"},"raw":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw"},"sequence_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sequence Position"}},"type":"object","required":["id","protein_variant_id","wild_type_residue","position","mutant_residue","raw"],"title":"MutationRead"},"NamedCount":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"NamedCount"},"ObservationRead":{"properties":{"time_point":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Time Point"},"time_point_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Point Unit"},"sd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sd"},"n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N"},"control_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Control Value"},"measurement_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measurement Type"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"text_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Description"}},"type":"object","title":"ObservationRead"},"ObservationRecord":{"properties":{"id":{"type":"integer","title":"Id"},"experiment_id":{"type":"integer","title":"Experiment Id"},"interaction_id":{"type":"integer","title":"Interaction Id"},"paper_id":{"type":"integer","title":"Paper Id"},"measurement_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measurement Type"},"measurement_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measurement Category"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"text_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Description"},"time_point":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Time Point"},"time_point_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Point Unit"},"sd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sd"},"n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N"},"control_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Control Value"},"products_summed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Products Summed"},"product_compound_ids":{"items":{"type":"integer"},"type":"array","title":"Product Compound Ids","default":[]}},"type":"object","required":["id","experiment_id","interaction_id","paper_id"],"title":"ObservationRecord"},"OriginSourceRecord":{"properties":{"database":{"type":"string","title":"Database"},"accession":{"type":"string","title":"Accession"},"url":{"type":"string","title":"Url"},"biosample":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Biosample"},"biosample_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Biosample Url"}},"type":"object","required":["database","accession","url"],"title":"OriginSourceRecord","description":"The public sequence record an origin was read from (no paper)."},"OriginType":{"type":"string","enum":["environmental_isolate","culture_collection","metagenome","sequence_database","synthetic","not_reported"],"title":"OriginType"},"PaginatedResponse_CompoundRead_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/CompoundRead"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[CompoundRead]"},"PaginatedResponse_DatasetReleaseRead_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/DatasetReleaseRead"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[DatasetReleaseRead]"},"PaginatedResponse_EnzymeKineticsRead_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/EnzymeKineticsRead"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[EnzymeKineticsRead]"},"PaginatedResponse_EnzymePropertiesRead_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/EnzymePropertiesRead"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[EnzymePropertiesRead]"},"PaginatedResponse_InteractionRead_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/InteractionRead"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[InteractionRead]"},"PaginatedResponse_JobResultItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/JobResultItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[JobResultItem]"},"PaginatedResponse_MicroorganismListItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/MicroorganismListItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[MicroorganismListItem]"},"PaginatedResponse_PaperListItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/PaperListItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[PaperListItem]"},"PaginatedResponse_PathwayListItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/PathwayListItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[PathwayListItem]"},"PaginatedResponse_PlasticListItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/PlasticListItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[PlasticListItem]"},"PaginatedResponse_ProteinListItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/ProteinListItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[ProteinListItem]"},"PaginatedResponse_ProteinListSequenceItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/ProteinListSequenceItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[ProteinListSequenceItem]"},"PaginatedResponse_ProteinVariantRead_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/ProteinVariantRead"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[ProteinVariantRead]"},"PaginatedResponse_SnapshotListItem_":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/SnapshotListItem"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"PaginatedResponse[SnapshotListItem]"},"PaperDetail":{"properties":{"id":{"type":"integer","title":"Id"},"citation":{"type":"string","title":"Citation"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"authors":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authors"},"journal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal"},"corresponding_author_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corresponding Author Country"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"pmid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pmid"},"microorganisms":{"items":{"$ref":"#/components/schemas/MicroorganismListItem"},"type":"array","title":"Microorganisms","default":[]},"proteins":{"items":{"$ref":"#/components/schemas/ProteinListItem"},"type":"array","title":"Proteins","default":[]},"protein_variants":{"items":{"$ref":"#/components/schemas/PaperVariantRef"},"type":"array","title":"Protein Variants","default":[]}},"type":"object","required":["id","citation","doi","year"],"title":"PaperDetail"},"PaperFootprint":{"properties":{"paper":{"$ref":"#/components/schemas/PaperListItem"},"interactions":{"items":{"$ref":"#/components/schemas/FootprintInteractionRead"},"type":"array","title":"Interactions","default":[]},"kinetics":{"items":{"$ref":"#/components/schemas/FootprintKineticsRead"},"type":"array","title":"Kinetics","default":[]},"properties":{"items":{"$ref":"#/components/schemas/FootprintPropertiesRead"},"type":"array","title":"Properties","default":[]},"microorganisms":{"items":{"$ref":"#/components/schemas/FootprintMicroorganismRead"},"type":"array","title":"Microorganisms","default":[]},"strains":{"items":{"$ref":"#/components/schemas/FootprintStrainRead"},"type":"array","title":"Strains","default":[]},"proteins":{"items":{"$ref":"#/components/schemas/FootprintProteinRead"},"type":"array","title":"Proteins","default":[]},"protein_variants":{"items":{"$ref":"#/components/schemas/FootprintProteinVariantRead"},"type":"array","title":"Protein Variants","default":[]},"counts":{"$ref":"#/components/schemas/PaperFootprintCounts"},"ingestion_lineage":{"items":{"$ref":"#/components/schemas/IngestionLineageEntry"},"type":"array","title":"Ingestion Lineage","default":[]}},"type":"object","required":["paper","counts"],"title":"PaperFootprint","description":"Complete set of records derived from a paper, for review and audit."},"PaperFootprintCounts":{"properties":{"interactions":{"type":"integer","title":"Interactions","default":0},"experiments":{"type":"integer","title":"Experiments","default":0},"observations":{"type":"integer","title":"Observations","default":0},"kinetics":{"type":"integer","title":"Kinetics","default":0},"properties":{"type":"integer","title":"Properties","default":0},"microorganisms":{"type":"integer","title":"Microorganisms","default":0},"proteins":{"type":"integer","title":"Proteins","default":0},"protein_variants":{"type":"integer","title":"Protein Variants","default":0}},"type":"object","title":"PaperFootprintCounts","description":"Aggregate counts of every entity type derived from the paper."},"PaperListItem":{"properties":{"id":{"type":"integer","title":"Id"},"citation":{"type":"string","title":"Citation"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"authors":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authors"},"journal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal"},"corresponding_author_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corresponding Author Country"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"pmid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pmid"}},"type":"object","required":["id","citation","doi","year"],"title":"PaperListItem","description":"A paper as the ``/papers`` list and detail serve it: :class:`PaperRead` plus its\n``updated_at``. Kept off ``PaperRead`` itself, which is embedded once per interaction in the\ndetail responses and need not carry a sync clock."},"PaperRead":{"properties":{"id":{"type":"integer","title":"Id"},"citation":{"type":"string","title":"Citation"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"authors":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authors"},"journal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal"},"corresponding_author_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corresponding Author Country"}},"type":"object","required":["id","citation","doi","year"],"title":"PaperRead"},"PaperVariantRef":{"properties":{"id":{"type":"integer","title":"Id"},"parent_protein_id":{"type":"integer","title":"Parent Protein Id"},"parent_protein_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Protein Accession"},"variant_name":{"type":"string","title":"Variant Name"},"variant_type":{"type":"string","title":"Variant Type"},"engineering_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engineering Method"},"performance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Performance"}},"type":"object","required":["id","parent_protein_id","variant_name","variant_type"],"title":"PaperVariantRef","description":"Minimal variant shape for the paper detail page (column data only, no relationships)."},"PathwayEnzymeRef":{"properties":{"id":{"type":"integer","title":"Id"},"plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"}},"type":"object","required":["id","plasticdb_id","name","genbank_id"],"title":"PathwayEnzymeRef"},"PathwayGraphEdge":{"properties":{"data":{"type":"object","title":"Data"}},"type":"object","required":["data"],"title":"PathwayGraphEdge"},"PathwayGraphNode":{"properties":{"data":{"type":"object","title":"Data"}},"type":"object","required":["data"],"title":"PathwayGraphNode"},"PathwayGraphResponse":{"properties":{"nodes":{"items":{"$ref":"#/components/schemas/PathwayGraphNode"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"$ref":"#/components/schemas/PathwayGraphEdge"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"PathwayGraphResponse"},"PathwayListItem":{"properties":{"id":{"type":"integer","title":"Id"},"plastic_id":{"type":"integer","title":"Plastic Id"},"plastic_name":{"type":"string","title":"Plastic Name","default":""},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"step_count":{"type":"integer","title":"Step Count","default":0}},"type":"object","required":["id","plastic_id"],"title":"PathwayListItem"},"PathwayRead":{"properties":{"id":{"type":"integer","title":"Id"},"plastic_id":{"type":"integer","title":"Plastic Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"organism_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Organism Id"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"steps":{"items":{"$ref":"#/components/schemas/ReactionStepRead"},"type":"array","title":"Steps","default":[]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","plastic_id","description","created_at"],"title":"PathwayRead"},"PathwayStepRef":{"properties":{"reaction_step_id":{"type":"integer","title":"Reaction Step Id"},"pathway_id":{"type":"integer","title":"Pathway Id"},"pathway_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pathway Name"},"step_order":{"type":"integer","title":"Step Order"},"role":{"type":"string","title":"Role"},"other_compound_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Other Compound Name"},"protein_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protein Name"},"protein_plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protein Plasticdb Id"}},"type":"object","required":["reaction_step_id","pathway_id","step_order","role"],"title":"PathwayStepRef","description":"A reaction step involving this compound, with its pathway context."},"PlasticComponentRead":{"properties":{"component_plastic_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Component Plastic Id"},"component_compound_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Component Compound Id"},"name":{"type":"string","title":"Name"},"component_type":{"type":"string","title":"Component Type"},"typical_fraction_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Typical Fraction Pct"},"fraction_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fraction Basis"}},"type":"object","required":["name","component_type"],"title":"PlasticComponentRead","description":"One constituent of a blend (a polymer or an additive), as canonical membership."},"PlasticContainingBlend":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},"type":"object","required":["id","name"],"title":"PlasticContainingBlend","description":"A blend that contains the plastic being viewed (reverse roll-up)."},"PlasticDetail":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"polymer_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Polymer Class"},"parent_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"},"smiles":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smiles"},"cas_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cas Number"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"trade_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trade Name"},"microorganism_count":{"type":"integer","title":"Microorganism Count","default":0},"protein_count":{"type":"integer","title":"Protein Count","default":0},"parent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Name"},"children":{"items":{"$ref":"#/components/schemas/PlasticParentRef"},"type":"array","title":"Children","default":[]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"microorganism_degrading_count":{"type":"integer","title":"Microorganism Degrading Count","default":0},"microorganism_inconclusive_count":{"type":"integer","title":"Microorganism Inconclusive Count","default":0},"microorganism_no_activity_count":{"type":"integer","title":"Microorganism No Activity Count","default":0},"protein_degrading_count":{"type":"integer","title":"Protein Degrading Count","default":0},"protein_inconclusive_count":{"type":"integer","title":"Protein Inconclusive Count","default":0},"protein_no_activity_count":{"type":"integer","title":"Protein No Activity Count","default":0},"microorganisms":{"items":{"$ref":"#/components/schemas/MicroorganismListItem"},"type":"array","title":"Microorganisms","default":[]},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"proteins":{"items":{"$ref":"#/components/schemas/ProteinListItem"},"type":"array","title":"Proteins","default":[]},"monomers":{"items":{"$ref":"#/components/schemas/CompoundRead"},"type":"array","title":"Monomers","default":[]},"components":{"items":{"$ref":"#/components/schemas/PlasticComponentRead"},"type":"array","title":"Components","default":[]},"containing_blends":{"items":{"$ref":"#/components/schemas/PlasticContainingBlend"},"type":"array","title":"Containing Blends","default":[]},"paper_count":{"type":"integer","title":"Paper Count","default":0},"chemical_reference":{"anyOf":[{"$ref":"#/components/schemas/ChemicalReferenceRead"},{"type":"null"}]},"vocabulary_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vocabulary Note"},"is_placeholder":{"type":"boolean","title":"Is Placeholder","default":false}},"type":"object","required":["id","name"],"title":"PlasticDetail"},"PlasticListItem":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"polymer_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Polymer Class"},"parent_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"},"smiles":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smiles"},"cas_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cas Number"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"trade_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trade Name"},"microorganism_count":{"type":"integer","title":"Microorganism Count","default":0},"protein_count":{"type":"integer","title":"Protein Count","default":0},"parent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Name"},"children":{"items":{"$ref":"#/components/schemas/PlasticParentRef"},"type":"array","title":"Children","default":[]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name"],"title":"PlasticListItem"},"PlasticOption":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"PlasticOption"},"PlasticParentRef":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"parent_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},"type":"object","required":["id","name"],"title":"PlasticParentRef"},"PlasticRead":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"polymer_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Polymer Class"},"parent_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"},"smiles":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smiles"},"cas_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cas Number"}},"type":"object","required":["id","name"],"title":"PlasticRead"},"PlasticShortcut":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"url":{"type":"string","title":"Url"},"match":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match"}},"type":"object","required":["id","url"],"title":"PlasticShortcut"},"PreparationPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EnzymePreparationRow"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","offset","limit"],"title":"PreparationPage"},"ProductPaperRef":{"properties":{"id":{"type":"integer","title":"Id"},"citation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citation"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"}},"type":"object","required":["id"],"title":"ProductPaperRef"},"ProductPlasticRef":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"}},"type":"object","required":["id","name"],"title":"ProductPlasticRef"},"ProteinAccessionLookup":{"properties":{"id":{"type":"integer","title":"Id"},"accession":{"type":"string","title":"Accession"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["id","accession"],"title":"ProteinAccessionLookup"},"ProteinActivityCounts":{"properties":{"degrader":{"type":"integer","title":"Degrader"},"negative_only":{"type":"integer","title":"Negative Only"},"inconclusive_only":{"type":"integer","title":"Inconclusive Only"},"mixed_nonpositive":{"type":"integer","title":"Mixed Nonpositive"},"untested":{"type":"integer","title":"Untested"},"tested":{"type":"integer","title":"Tested"}},"type":"object","required":["degrader","negative_only","inconclusive_only","mixed_nonpositive","untested","tested"],"title":"ProteinActivityCounts"},"ProteinActivityStats":{"properties":{"wild_type":{"$ref":"#/components/schemas/ProteinActivityCounts"},"engineered":{"$ref":"#/components/schemas/ProteinActivityCounts"},"both":{"$ref":"#/components/schemas/ProteinActivityCounts"}},"type":"object","required":["wild_type","engineered","both"],"title":"ProteinActivityStats"},"ProteinConstructDetail":{"properties":{"evidence_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Location"},"evidence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Text"},"certainty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Certainty"},"id":{"type":"integer","title":"Id"},"protein_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Scope"},"local_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Local Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"provenance":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Provenance"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence"},"sequence_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence Role"},"sequence_frame":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence Frame"},"archived_reference":{"type":"boolean","title":"Archived Reference","default":false},"sequence_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence Status"},"components":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Components"},"chains":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Chains"},"coordinate_mappings":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Coordinate Mappings"},"structures":{"items":{"$ref":"#/components/schemas/ConstructStructureLink"},"type":"array","title":"Structures","default":[]}},"type":"object","required":["id"],"title":"ProteinConstructDetail"},"ProteinConstructRow":{"properties":{"evidence_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Location"},"evidence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Text"},"certainty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Certainty"},"id":{"type":"integer","title":"Id"},"protein_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"},"paper_ingestion_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Ingestion Id"},"source_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Scope"},"local_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Local Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"provenance":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Provenance"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence"},"sequence_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence Role"},"sequence_frame":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence Frame"},"archived_reference":{"type":"boolean","title":"Archived Reference","default":false},"sequence_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence Status"},"components":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Components"},"chains":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Chains"},"coordinate_mappings":{"anyOf":[{"items":{"type":"object"},"type":"array"},{"type":"null"}],"title":"Coordinate Mappings"}},"type":"object","required":["id"],"title":"ProteinConstructRow"},"ProteinDetail":{"properties":{"activity_class":{"type":"string","title":"Activity Class","default":"untested"},"id":{"type":"integer","title":"Id"},"kind":{"type":"string","title":"Kind","default":"wild_type"},"variant_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Type"},"parent_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Accession"},"plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"has_signal_peptide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Signal Peptide"},"uniprot_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uniprot Accession"},"pdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdb Id"},"ec_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ec Number"},"source_microorganism":{"anyOf":[{"$ref":"#/components/schemas/MicroorganismListItem"},{"type":"null"}]},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"papers":{"items":{"$ref":"#/components/schemas/PaperRead"},"type":"array","title":"Papers","default":[]},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"best_kcat_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Best Kcat Km"},"best_kcat_km_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Kcat Km Unit"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"v1_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"V1 Id"},"database_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database Name"},"gene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gene"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence"},"structure_file":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Structure File"},"has_structure":{"type":"boolean","title":"Has Structure","default":false},"uniprot_protein_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uniprot Protein Name"},"uniprot_go_terms":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Uniprot Go Terms"},"active_site_residues":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Active Site Residues"},"signal_peptide_cleavage_site":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Signal Peptide Cleavage Site"},"cross_references":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Cross References"},"structures":{"items":{"$ref":"#/components/schemas/ProteinStructureRead"},"type":"array","title":"Structures","default":[]},"plastics":{"items":{"$ref":"#/components/schemas/PlasticRead"},"type":"array","title":"Plastics","default":[]},"variant_degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Variant Degradation Links","default":[]},"interactions":{"items":{"$ref":"#/components/schemas/InteractionRead"},"type":"array","title":"Interactions","default":[]},"indirect_interactions":{"items":{"$ref":"#/components/schemas/InteractionRead"},"type":"array","title":"Indirect Interactions","default":[]},"variants":{"items":{"$ref":"#/components/schemas/ProteinVariantRead"},"type":"array","title":"Variants","default":[]},"kinetics":{"items":{"$ref":"#/components/schemas/EnzymeKineticsRead"},"type":"array","title":"Kinetics","default":[]},"properties":{"items":{"$ref":"#/components/schemas/EnzymePropertiesRead"},"type":"array","title":"Properties","default":[]},"identity_sources":{"items":{"$ref":"#/components/schemas/IdentitySourcePublic"},"type":"array","title":"Identity Sources","default":[]},"model_input":{"anyOf":[{"$ref":"#/components/schemas/ModelInputRead"},{"type":"null"}]},"origin":{"anyOf":[{"$ref":"#/components/schemas/ProteinOriginRead"},{"type":"null"}]},"reaction_products":{"anyOf":[{"$ref":"#/components/schemas/ReactionProducts"},{"type":"null"}]},"view":{"anyOf":[{"type":"string","enum":["summary","full"]},{"type":"null"}],"title":"View","description":"`summary` when the per-record evidence lists were left out (the default view); absent or null for `view=full`."},"counts":{"anyOf":[{"$ref":"#/components/schemas/ProteinDetailCounts"},{"type":"null"}],"description":"Summary view only: the sizes of the evidence lists it leaves out (`interactions`, `indirect_interactions`, `variants`, `kinetics`, `properties`)."}},"type":"object","required":["id","plasticdb_id","name"],"title":"ProteinDetail"},"ProteinDetailCounts":{"properties":{"interactions":{"type":"integer","title":"Interactions","description":"Direct interactions; page them from `/interactions`."},"indirect_interactions":{"type":"integer","title":"Indirect Interactions","description":"Interactions of this protein's variants."},"variants":{"type":"integer","title":"Variants","description":"Variants; page them from `/variants`."},"kinetics":{"type":"integer","title":"Kinetics","description":"Kinetics rows; page them from `/kinetics`."},"properties":{"type":"integer","title":"Properties","description":"Enzyme-property rows; page them from `/properties`."}},"type":"object","required":["interactions","indirect_interactions","variants","kinetics","properties"],"title":"ProteinDetailCounts","description":"How many rows each evidence list holds, sent instead of the lists by the\nsummary view (``GET /proteins/{accession}``, the default since 2.89.0)."},"ProteinListItem":{"properties":{"activity_class":{"type":"string","title":"Activity Class","default":"untested"},"id":{"type":"integer","title":"Id"},"kind":{"type":"string","title":"Kind","default":"wild_type"},"variant_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Type"},"parent_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Accession"},"plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"has_signal_peptide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Signal Peptide"},"uniprot_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uniprot Accession"},"pdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdb Id"},"ec_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ec Number"},"source_microorganism":{"anyOf":[{"$ref":"#/components/schemas/MicroorganismListItem"},{"type":"null"}]},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"papers":{"items":{"$ref":"#/components/schemas/PaperRead"},"type":"array","title":"Papers","default":[]},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"best_kcat_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Best Kcat Km"},"best_kcat_km_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Kcat Km Unit"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","plasticdb_id","name"],"title":"ProteinListItem"},"ProteinListSequenceItem":{"properties":{"activity_class":{"type":"string","title":"Activity Class","default":"untested"},"id":{"type":"integer","title":"Id"},"kind":{"type":"string","title":"Kind","default":"wild_type"},"variant_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Type"},"parent_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Accession"},"plasticdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"has_signal_peptide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Signal Peptide"},"uniprot_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uniprot Accession"},"pdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdb Id"},"ec_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ec Number"},"source_microorganism":{"anyOf":[{"$ref":"#/components/schemas/MicroorganismListItem"},{"type":"null"}]},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"papers":{"items":{"$ref":"#/components/schemas/PaperRead"},"type":"array","title":"Papers","default":[]},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"},"best_kcat_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Best Kcat Km"},"best_kcat_km_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Best Kcat Km Unit"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence","description":"The amino-acid sequence (a variant's own). Only sent with `include_sequence=true`."}},"type":"object","required":["id","plasticdb_id","name"],"title":"ProteinListSequenceItem","description":"A ``/proteins`` row; ``sequence`` is present only with ``include_sequence=true``."},"ProteinOriginRead":{"properties":{"origin_type":{"type":"string","title":"Origin Type"},"origin_label":{"type":"string","title":"Origin Label"},"environment_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment Type"},"environment_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment Label"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"curated":{"type":"boolean","title":"Curated","default":false},"source_record":{"anyOf":[{"$ref":"#/components/schemas/OriginSourceRecord"},{"type":"null"}]},"inherited_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inherited From"}},"type":"object","required":["origin_type","origin_label"],"title":"ProteinOriginRead","description":"Where a wild-type enzyme came from (``Protein.origin_*``, 0038)."},"ProteinStructureRead":{"properties":{"discovery_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discovery Source"},"discovery_evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discovery Evidence"},"id":{"type":"integer","title":"Id"},"pdb_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdb Id"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method"},"resolution":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Resolution"},"deposition_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deposition Date"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"model_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Url"},"is_primary":{"type":"boolean","title":"Is Primary","default":false},"protein_variant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"},"sequence_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence Check"},"sequence_identity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sequence Identity"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By"},"prediction_attribution":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Prediction Attribution"}},"type":"object","required":["id"],"title":"ProteinStructureRead"},"ProteinVariantRead":{"properties":{"synonyms":{"items":{"type":"string"},"type":"array","title":"Synonyms","default":[]},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"numbering_scheme_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme Code"},"numbering_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Reference"},"numbering_scheme_code_proposed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme Code Proposed"},"originating_paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Originating Paper Id"},"originating_doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Originating Doi"},"originating_paper_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Originating Paper Source"},"id":{"type":"integer","title":"Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"parent_protein_id":{"type":"integer","title":"Parent Protein Id"},"variant_name":{"type":"string","title":"Variant Name"},"variant_type":{"type":"string","title":"Variant Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence"},"engineering_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engineering Method"},"performance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Performance"},"numbering_scheme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme"},"numbering_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Numbering Offset"},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"mutations":{"items":{"$ref":"#/components/schemas/MutationRead"},"type":"array","title":"Mutations","default":[]},"kinetics":{"items":{"$ref":"#/components/schemas/EnzymeKineticsRead"},"type":"array","title":"Kinetics","default":[]},"properties":{"items":{"$ref":"#/components/schemas/EnzymePropertiesRead"},"type":"array","title":"Properties","default":[]}},"type":"object","required":["id","parent_protein_id","variant_name","variant_type"],"title":"ProteinVariantRead"},"ProteinVariantRef":{"properties":{"id":{"type":"integer","title":"Id"},"variant_name":{"type":"string","title":"Variant Name"}},"type":"object","required":["id","variant_name"],"title":"ProteinVariantRef","description":"Minimal variant reference for embedding in kinetics/properties rows."},"PublicStats":{"properties":{"plastics":{"type":"integer","title":"Plastics"},"papers":{"type":"integer","title":"Papers"},"pathways":{"type":"integer","title":"Pathways"},"compounds":{"type":"integer","title":"Compounds","description":"Every compound in the catalogue."},"microorganisms":{"type":"integer","title":"Microorganisms","description":"Organisms with positive degradation evidence under the requested `evidence_scope`."},"microorganisms_whole_organism":{"type":"integer","title":"Microorganisms Whole Organism"},"microorganisms_via_enzyme":{"type":"integer","title":"Microorganisms Via Enzyme"},"proteins":{"type":"integer","title":"Proteins","description":"Wild-type plus engineered degraders."},"proteins_wild_type":{"type":"integer","title":"Proteins Wild Type"},"proteins_variants":{"type":"integer","title":"Proteins Variants"}},"type":"object","required":["plastics","papers","pathways","compounds","microorganisms","microorganisms_whole_organism","microorganisms_via_enzyme","proteins","proteins_wild_type","proteins_variants"],"title":"PublicStats","description":"``GET /stats``: the headline counts, in the order the endpoint builds them."},"ReactionProducts":{"properties":{"pathway_steps":{"items":{"$ref":"#/components/schemas/CuratedReactionStep"},"type":"array","title":"Pathway Steps","default":[]},"reported":{"items":{"$ref":"#/components/schemas/ReportedProductsByPlastic"},"type":"array","title":"Reported","default":[]}},"type":"object","title":"ReactionProducts"},"ReactionStepRead":{"properties":{"id":{"type":"integer","title":"Id"},"pathway_id":{"type":"integer","title":"Pathway Id"},"step_order":{"type":"integer","title":"Step Order"},"substrate_compound_id":{"type":"integer","title":"Substrate Compound Id"},"product_compound_id":{"type":"integer","title":"Product Compound Id"},"protein_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence"},"enzyme_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enzyme Name"},"enzyme_accessions":{"items":{"type":"string"},"type":"array","title":"Enzyme Accessions","default":[]},"ec_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ec Number"},"substrate_compartment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Substrate Compartment"},"product_compartment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Compartment"},"step_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Type"},"substrate_compound":{"anyOf":[{"$ref":"#/components/schemas/CompoundRead"},{"type":"null"}]},"product_compound":{"anyOf":[{"$ref":"#/components/schemas/CompoundRead"},{"type":"null"}]},"protein":{"anyOf":[{"$ref":"#/components/schemas/PathwayEnzymeRef"},{"type":"null"}]}},"type":"object","required":["id","pathway_id","step_order","substrate_compound_id","product_compound_id","protein_id","description","evidence"],"title":"ReactionStepRead"},"RecordGoneBody":{"properties":{"detail":{"type":"string","title":"Detail"},"accession":{"type":"string","title":"Accession"},"reason":{"type":"string","enum":["withdrawn"],"const":"withdrawn","title":"Reason","default":"withdrawn"}},"type":"object","required":["detail","accession"],"title":"RecordGoneBody","description":"Body of every record 410."},"RecordRedirect":{"properties":{"accession":{"type":"string","title":"Accession","description":"The record the redirect points at."},"location":{"type":"string","title":"Location","description":"Its API path, with the original suffix and query."},"kind":{"type":"string","enum":["wild_type","engineered","microorganism"],"title":"Kind","description":"What `accession` is: a wild-type protein, an engineered variant, or a microorganism."},"reason":{"type":"string","enum":["merged","engineered_variant"],"title":"Reason","description":"`merged`: the requested accession was merged into `merged_into`. `engineered_variant`: it is a live engineered variant, whose record lives under `/variants`."},"merged_into":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merged Into","description":"On a merge: the surviving accession (= `accession`)."}},"type":"object","required":["accession","location","kind","reason"],"title":"RecordRedirect","description":"Body of every record 301; ``Location`` carries the same ``location``."},"ReferenceMonomerRead":{"properties":{"compound_id":{"type":"integer","title":"Compound Id"},"name":{"type":"string","title":"Name"},"formula":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formula"},"role":{"type":"string","title":"Role","default":"monomer"}},"type":"object","required":["compound_id","name"],"title":"ReferenceMonomerRead","description":"A monomer of a plastic, per the reviewed chemistry reference."},"ReleaseArtefactFile":{"properties":{"path":{"type":"string","title":"Path","description":"Path inside the release, e.g. 'parquet/proteins.parquet'."},"kind":{"type":"string","title":"Kind","description":"'table', 'diamond_db', 'reference_manifest', 'hmm_library', 'hmm_metadata', 'pathway_db', 'pathway_references' or 'pathway_curation'."},"sha256":{"type":"string","title":"Sha256"},"size":{"type":"integer","title":"Size","description":"Size in bytes."},"table":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Table","description":"Snapshot table, for 'table'."},"rows":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rows","description":"Row count, for 'table'."},"download_url":{"type":"string","title":"Download Url"}},"type":"object","required":["path","kind","sha256","size","download_url"],"title":"ReleaseArtefactFile","description":"One file of a release's artefacts, as its manifest records it."},"ReleaseArtefacts":{"properties":{"schema_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schema Id","description":"Manifest format id."},"release":{"type":"string","title":"Release","description":"The release whose files these are."},"inherited_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inherited From","description":"Set when this release cut no snapshot (no data change) and shares the artefacts of that earlier release, as it shares its DOI."},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"},"manifest_url":{"type":"string","title":"Manifest Url"},"manifest_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Manifest Sha256"},"files":{"items":{"$ref":"#/components/schemas/ReleaseArtefactFile"},"type":"array","title":"Files"},"tools":{"additionalProperties":{"$ref":"#/components/schemas/ReleaseToolVersion"},"type":"object","title":"Tools"},"hmm_library_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hmm Library Source","description":"'release_build' (this release's calibrated library), 'served' (the library the site was serving), or null if none."},"pathways":{"anyOf":[{"$ref":"#/components/schemas/ReleasePathways"},{"type":"null"}],"description":"The pathway search databases pinned pathway analyses run against (their files are in `files`). Null for a release made before 2.85.0."},"structures":{"anyOf":[{"$ref":"#/components/schemas/ReleaseStructures"},{"type":"null"}],"description":"The structure coordinate files (S5b), summarised: they are listed one by one in MANIFEST.json, not in `files`. Null for a release made before 2.84.0."}},"type":"object","required":["release","manifest_url"],"title":"ReleaseArtefacts","description":"What ``MANIFEST.json`` says, for one release (S4)."},"ReleasePathway":{"properties":{"key":{"type":"string","title":"Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"plastic":{"type":"string","title":"Plastic","description":"The `target_plastic` it answers."}},"type":"object","required":["key","plastic"],"title":"ReleasePathway"},"ReleasePathways":{"properties":{"archived":{"type":"boolean","title":"Archived"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Why not, when not."},"pathways":{"items":{"$ref":"#/components/schemas/ReleasePathway"},"type":"array","title":"Pathways"}},"type":"object","required":["archived"],"title":"ReleasePathways","description":"Whether a release archived its pathway DIAMOND databases, and which."},"ReleaseRunStatus":{"properties":{"running":{"type":"boolean","title":"Running","description":"True while a release is in progress (running and not older than the stale-run ceiling)."},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"The version being cut, while one is running."},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At","description":"When the running release started (UTC)."}},"type":"object","required":["running"],"title":"ReleaseRunStatus","description":"Whether a dataset release is in progress — nothing else."},"ReleaseStructureLicence":{"properties":{"licence":{"type":"string","title":"Licence","description":"SPDX id, e.g. 'CC0-1.0' or 'CC-BY-4.0'."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"citation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Citation"},"files":{"type":"integer","title":"Files","default":0}},"type":"object","required":["licence"],"title":"ReleaseStructureLicence"},"ReleaseStructures":{"properties":{"files":{"type":"integer","title":"Files","description":"Coordinate files (one per structure row)."},"bytes":{"type":"integer","title":"Bytes","description":"Their total size, compressed."},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format"},"path_pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path Pattern","description":"Where each file is: `structures/<protein_structures.id>.pdb.gz`, under this release's artefacts. `GET /api/v1/releases/{version}/structures/{structure_id}` redirects to it."},"licences":{"additionalProperties":{"$ref":"#/components/schemas/ReleaseStructureLicence"},"type":"object","title":"Licences","description":"By structure source."},"excluded_sources":{"additionalProperties":{"type":"string"},"type":"object","title":"Excluded Sources","description":"Sources never archived, and why."},"figshare":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Figshare","description":"Whether the coordinates were uploaded to the release's Figshare article (`uploaded`, and `reason` when not)."}},"type":"object","required":["files","bytes"],"title":"ReleaseStructures","description":"A release's structure coordinates: count, size, licence per source."},"ReleaseToolVersion":{"properties":{"pinned":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pinned"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Version probe on the exporting host: 'ok' = the pin."},"reported":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reported","description":"What the binary printed."}},"type":"object","title":"ReleaseToolVersion"},"ReportedProduct":{"properties":{"compound":{"$ref":"#/components/schemas/CompoundRef"},"measurement_types":{"items":{"type":"string"},"type":"array","title":"Measurement Types","default":[]},"papers":{"items":{"$ref":"#/components/schemas/ProductPaperRef"},"type":"array","title":"Papers","default":[]}},"type":"object","required":["compound"],"title":"ReportedProduct","description":"One compound the actor's observations report, with who reported it."},"ReportedProductsByPlastic":{"properties":{"plastic":{"$ref":"#/components/schemas/ProductPlasticRef"},"products":{"items":{"$ref":"#/components/schemas/ReportedProduct"},"type":"array","title":"Products","default":[]},"totals":{"items":{"$ref":"#/components/schemas/ReportedTotal"},"type":"array","title":"Totals","default":[]}},"type":"object","required":["plastic"],"title":"ReportedProductsByPlastic"},"ReportedTotal":{"properties":{"compounds":{"items":{"$ref":"#/components/schemas/CompoundRef"},"type":"array","title":"Compounds"},"measurement_types":{"items":{"type":"string"},"type":"array","title":"Measurement Types","default":[]},"papers":{"items":{"$ref":"#/components/schemas/ProductPaperRef"},"type":"array","title":"Papers","default":[]},"readings":{"items":{"$ref":"#/components/schemas/TotalReading"},"type":"array","title":"Readings","default":[]}},"type":"object","required":["compounds"],"title":"ReportedTotal","description":"A set of compounds a paper quantified only as their sum (\"TPA + MHET\")."},"ResultEnum":{"type":"string","enum":["positive","negative","inconclusive"],"title":"ResultEnum"},"RowEvidenceScope":{"type":"string","enum":["organism_or_enzyme","whole_organism"],"title":"RowEvidenceScope","description":"``evidence_scope`` where it selects *interaction rows* (a count, a detail page's evidence),\nnot entities."},"SampleSourceRead":{"properties":{"id":{"type":"integer","title":"Id"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"environment_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment Type"},"sample_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample Description"}},"type":"object","required":["id"],"title":"SampleSourceRead"},"SearchGroup":{"properties":{"total":{"type":"integer","title":"Total"},"more_query":{"type":"string","title":"More Query"},"items":{"items":{"$ref":"#/components/schemas/GlobalSearchResult"},"type":"array","title":"Items"}},"type":"object","required":["total","more_query","items"],"title":"SearchGroup"},"SearchPage":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/GlobalSearchResult"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"SearchPage"},"SearchSuggestion":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"SearchSuggestion"},"SnapshotLatestResponse":{"properties":{"release_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Release Label"},"figshare_doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Figshare Doi"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"entity_counts":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Entity Counts"}},"type":"object","required":["release_label","figshare_doi","published_at","entity_counts"],"title":"SnapshotLatestResponse"},"SnapshotListItem":{"properties":{"id":{"type":"integer","title":"Id"},"release_label":{"type":"string","title":"Release Label"},"status":{"type":"string","title":"Status"},"entity_counts":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Entity Counts"},"figshare_doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Figshare Doi"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"}},"type":"object","required":["id","release_label","status","entity_counts","figshare_doi","created_at","published_at"],"title":"SnapshotListItem"},"SnapshotRead":{"properties":{"id":{"type":"integer","title":"Id"},"release_label":{"type":"string","title":"Release Label"},"status":{"type":"string","title":"Status"},"entity_counts":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Entity Counts"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum"},"figshare_doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Figshare Doi"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"}},"type":"object","required":["id","release_label","status","entity_counts","file_size","checksum","figshare_doi","created_at","published_at"],"title":"SnapshotRead"},"SoleCarbonSource":{"type":"string","enum":["yes","no","not_stated"],"title":"SoleCarbonSource","description":"Was the plastic the sole carbon source in the assay? ``not_stated`` is the paper saying\nnothing (stored NULL)."},"StatsByCountry":{"properties":{"microorganisms":{"items":{"$ref":"#/components/schemas/CountryCount"},"type":"array","title":"Microorganisms"},"proteins":{"items":{"$ref":"#/components/schemas/CountryCount"},"type":"array","title":"Proteins"},"plastics":{"items":{"$ref":"#/components/schemas/CountryCount"},"type":"array","title":"Plastics"},"papers":{"items":{"$ref":"#/components/schemas/CountryCount"},"type":"array","title":"Papers"}},"type":"object","required":["microorganisms","proteins","plastics","papers"],"title":"StatsByCountry"},"StatsCharts":{"properties":{"environments":{"items":{"$ref":"#/components/schemas/CodedCount"},"type":"array","title":"Environments"},"enzyme_origins":{"items":{"$ref":"#/components/schemas/CodedCount"},"type":"array","title":"Enzyme Origins"},"publications_per_year":{"items":{"$ref":"#/components/schemas/YearCount"},"type":"array","title":"Publications Per Year"},"top_plastics":{"items":{"$ref":"#/components/schemas/LabelCount"},"type":"array","title":"Top Plastics"},"current_year":{"type":"integer","title":"Current Year"}},"type":"object","required":["environments","enzyme_origins","publications_per_year","top_plastics","current_year"],"title":"StatsCharts"},"StrainOccurrenceRead":{"properties":{"strain_designation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strain Designation"},"genome_assembly_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genome Assembly Accession"},"culture_collection_ids":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Culture Collection Ids"},"sample_source":{"anyOf":[{"$ref":"#/components/schemas/SampleSourceRead"},{"type":"null"}]},"genetic_background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genetic Background"},"id":{"type":"integer","title":"Id"},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"counts_for_species":{"type":"boolean","title":"Counts For Species","description":"False for an expression host, knockout or engineered strain: its assay is not evidence\nthat the species itself degrades the plastic.","readOnly":true}},"type":"object","required":["id","counts_for_species"],"title":"StrainOccurrenceRead","description":"A microorganism's occurrence in a specific paper (for the organism page)."},"StrainOccurrenceRef":{"properties":{"strain_designation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strain Designation"},"genome_assembly_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genome Assembly Accession"},"culture_collection_ids":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Culture Collection Ids"},"sample_source":{"anyOf":[{"$ref":"#/components/schemas/SampleSourceRead"},{"type":"null"}]},"genetic_background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genetic Background"},"counts_for_species":{"type":"boolean","title":"Counts For Species","description":"False for an expression host, knockout or engineered strain: its assay is not evidence\nthat the species itself degrades the plastic.","readOnly":true}},"type":"object","required":["counts_for_species"],"title":"StrainOccurrenceRef","description":"Strain-/isolate-level facts for a microorganism as reported in one study."},"StrainPlasticCell":{"properties":{"plastic":{"$ref":"#/components/schemas/app__schemas__entities__PlasticRef"},"positive":{"type":"integer","title":"Positive","default":0},"inconclusive":{"type":"integer","title":"Inconclusive","default":0},"negative":{"type":"integer","title":"Negative","default":0},"paper_count":{"type":"integer","title":"Paper Count","default":0},"call":{"type":"string","title":"Call"}},"type":"object","required":["plastic","call"],"title":"StrainPlasticCell","description":"One cell of an organism's strain × plastic matrix (C9, R04-8)."},"StrainSummary":{"properties":{"designation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Designation"},"occurrence_ids":{"items":{"type":"integer"},"type":"array","title":"Occurrence Ids","default":[]},"genetic_background":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genetic Background"},"culture_collection_ids":{"items":{"type":"string"},"type":"array","title":"Culture Collection Ids","default":[]},"genome_assembly_accessions":{"items":{"type":"string"},"type":"array","title":"Genome Assembly Accessions","default":[]},"isolation_sources":{"items":{"type":"string"},"type":"array","title":"Isolation Sources","default":[]},"papers":{"items":{"$ref":"#/components/schemas/PaperRead"},"type":"array","title":"Papers","default":[]},"plastics":{"items":{"$ref":"#/components/schemas/StrainPlasticCell"},"type":"array","title":"Plastics","default":[]},"possible_duplicates":{"items":{"type":"string"},"type":"array","title":"Possible Duplicates","default":[]},"counts_for_species":{"type":"boolean","title":"Counts For Species","readOnly":true}},"type":"object","required":["counts_for_species"],"title":"StrainSummary","description":"One strain of an organism, as the papers name it (C9, R04-1/R04-8)."},"SubstrateForm":{"type":"string","enum":["model_substrate","amorphous_film","crystalline_film","film","powder","emulsion","granule","particle","whole_polymer"],"title":"SubstrateForm"},"TaxonomyGroupStats":{"properties":{"rank":{"type":"string","title":"Rank"},"name":{"type":"string","title":"Name"},"microbe_total":{"type":"integer","title":"Microbe Total"},"evidenced_microbe_total":{"type":"integer","title":"Evidenced Microbe Total"},"protein_total":{"type":"integer","title":"Protein Total"},"plastic_total":{"type":"integer","title":"Plastic Total"},"paper_total":{"type":"integer","title":"Paper Total"},"top_plastics":{"items":{"$ref":"#/components/schemas/NamedCount"},"type":"array","title":"Top Plastics"},"top_environments":{"items":{"$ref":"#/components/schemas/EnvironmentCount"},"type":"array","title":"Top Environments"},"temperature_class":{"$ref":"#/components/schemas/TemperatureClassCounts"},"top_microorganisms":{"items":{"$ref":"#/components/schemas/TaxonomyTopMicroorganism"},"type":"array","title":"Top Microorganisms"}},"type":"object","required":["rank","name","microbe_total","evidenced_microbe_total","protein_total","plastic_total","paper_total","top_plastics","top_environments","temperature_class","top_microorganisms"],"title":"TaxonomyGroupStats"},"TaxonomyTopMicroorganism":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"tax_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"protein_count":{"type":"integer","title":"Protein Count"},"evidence_count":{"type":"integer","title":"Evidence Count"}},"type":"object","required":["id","name","protein_count","evidence_count"],"title":"TaxonomyTopMicroorganism"},"TempClass":{"type":"string","enum":["psychrophile","mesophile","thermophile"],"title":"TempClass","description":"Growth-temperature class, bucketed from the organism's recorded optimum growth temperature\n(``growth_temp_opt``) — not from any assay temperature."},"TemperatureClassCounts":{"properties":{"psychrophile":{"type":"integer","title":"Psychrophile"},"mesophile":{"type":"integer","title":"Mesophile"},"thermophile":{"type":"integer","title":"Thermophile"},"unknown":{"type":"integer","title":"Unknown"}},"type":"object","required":["psychrophile","mesophile","thermophile","unknown"],"title":"TemperatureClassCounts"},"TotalReading":{"properties":{"observation_id":{"type":"integer","title":"Observation Id"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"paper_id":{"type":"integer","title":"Paper Id"}},"type":"object","required":["observation_id","paper_id"],"title":"TotalReading","description":"One summed observation's value: the total of the set, not per compound."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VariantDetail":{"properties":{"synonyms":{"items":{"type":"string"},"type":"array","title":"Synonyms","default":[]},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"numbering_scheme_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme Code"},"numbering_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Reference"},"numbering_scheme_code_proposed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme Code Proposed"},"originating_paper_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Originating Paper Id"},"originating_doi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Originating Doi"},"originating_paper_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Originating Paper Source"},"activity_class":{"type":"string","title":"Activity Class","default":"untested"},"originating_paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"id":{"type":"integer","title":"Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"variant_name":{"type":"string","title":"Variant Name"},"variant_type":{"type":"string","title":"Variant Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"sequence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sequence"},"engineering_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engineering Method"},"performance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Performance"},"numbering_scheme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numbering Scheme"},"numbering_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Numbering Offset"},"structures":{"items":{"$ref":"#/components/schemas/ProteinStructureRead"},"type":"array","title":"Structures","default":[]},"primary_structure":{"anyOf":[{"$ref":"#/components/schemas/ProteinStructureRead"},{"type":"null"}]},"structure_file":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Structure File"},"has_signal_peptide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Signal Peptide"},"signal_peptide_cleavage_site":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Signal Peptide Cleavage Site"},"parent_protein":{"anyOf":[{"$ref":"#/components/schemas/VariantParentRef"},{"type":"null"}]},"paper":{"anyOf":[{"$ref":"#/components/schemas/PaperRead"},{"type":"null"}]},"mutations":{"items":{"$ref":"#/components/schemas/MutationRead"},"type":"array","title":"Mutations","default":[]},"kinetics":{"items":{"$ref":"#/components/schemas/EnzymeKineticsRead"},"type":"array","title":"Kinetics","default":[]},"properties":{"items":{"$ref":"#/components/schemas/EnzymePropertiesRead"},"type":"array","title":"Properties","default":[]},"plastics":{"items":{"$ref":"#/components/schemas/PlasticRead"},"type":"array","title":"Plastics","default":[]},"interactions":{"items":{"$ref":"#/components/schemas/InteractionRead"},"type":"array","title":"Interactions","default":[]},"degradation_links":{"items":{"$ref":"#/components/schemas/DegradationLink"},"type":"array","title":"Degradation Links","default":[]},"identity_sources":{"items":{"$ref":"#/components/schemas/IdentitySourcePublic"},"type":"array","title":"Identity Sources","default":[]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"model_input":{"anyOf":[{"$ref":"#/components/schemas/ModelInputRead"},{"type":"null"}]},"origin":{"anyOf":[{"$ref":"#/components/schemas/ProteinOriginRead"},{"type":"null"}]},"reaction_products":{"anyOf":[{"$ref":"#/components/schemas/ReactionProducts"},{"type":"null"}]}},"type":"object","required":["id","variant_name","variant_type"],"title":"VariantDetail","description":"Full detail for one engineered protein variant, for its own page."},"VariantParentRef":{"properties":{"id":{"type":"integer","title":"Id"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"name":{"type":"string","title":"Name"},"genbank_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genbank Id"},"uniprot_accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uniprot Accession"}},"type":"object","required":["id","name"],"title":"VariantParentRef","description":"Minimal parent-protein context shown on a variant page."},"YearCount":{"properties":{"year":{"type":"integer","title":"Year"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["year","count"],"title":"YearCount"},"app__schemas__compounds__PlasticRef":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"}},"type":"object","required":["id","name"],"title":"PlasticRef","description":"Minimal plastic reference for compound detail — avoids circular import."},"app__schemas__entities__PlasticRef":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"}},"type":"object","required":["id","name"],"title":"PlasticRef","description":"Minimal plastic reference for embedding in interaction responses."}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/auth/login"}}},"HTTPBearer":{"type":"http","scheme":"bearer"},"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"paths":{"/api/v1/downloads/dataset.zip":{"get":{"tags":["downloads"],"summary":"Dataset Zip","description":"Download every public record as a ZIP of CSVs, with a README and licence.","operationId":"dataset_zip_api_v1_downloads_dataset_zip_get","parameters":[{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"503":{"description":"The archive is being built or its store is unreachable. Retry after `Retry-After` seconds, or use `/downloads/dataset.json`.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","title":"ArchiveUnavailable","required":["detail","reason"],"properties":{"detail":{"type":"string"},"reason":{"type":"string","enum":["archive_unavailable"]}}}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/downloads/dataset.json":{"get":{"tags":["downloads"],"summary":"Dataset Json","description":"Download the full dataset as a streaming JSON object.","operationId":"dataset_json_api_v1_downloads_dataset_json_get","parameters":[{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/downloads/proteins.fasta":{"get":{"tags":["downloads"],"summary":"Proteins Fasta","description":"Download protein sequences as a streaming multi-FASTA file.","operationId":"proteins_fasta_api_v1_downloads_proteins_fasta_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"plasticdb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"}},{"name":"accession","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"}},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts.","title":"Microorganism"},"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts."},{"name":"lineage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"Filter by substrate form (vocabulary; unknown is a 422)","title":"Substrate Form"},"description":"Filter by substrate form (vocabulary; unknown is a 422)"},{"name":"include_negative","in":"query","required":false,"schema":{"type":"boolean","description":"Drop the result filter entirely and export every public record, negatives and untested entities included. This is the way back to an unfiltered export: with neither this nor `polarity`, the default is `positive`.","default":false,"title":"Include Negative"},"description":"Drop the result filter entirely and export every public record, negatives and untested entities included. This is the way back to an unfiltered export: with neither this nor `polarity`, the default is `positive`."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Filter by interaction result. **Defaults to `positive`** - an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider (proteins.csv 715 -> 685 rows; proteins.fasta 606 -> 584 records, the difference being entities with no sequence). Pass `include_negative=true` for every public record.","title":"Polarity"},"description":"Filter by interaction result. **Defaults to `positive`** - an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider (proteins.csv 715 -> 685 rows; proteins.fasta 606 -> 584 records, the difference being entities with no sequence). Pass `include_negative=true` for every public record."},{"name":"min_kcat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum kcat (s⁻¹)","title":"Min Kcat"},"description":"Minimum kcat (s⁻¹)"},{"name":"max_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum Km (mM)","title":"Max Km"},"description":"Maximum Km (mM)"},{"name":"min_kcat_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)","title":"Min Kcat Km"},"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)"},{"name":"min_vmax","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum Vmax (U/mg)","title":"Min Vmax"},"description":"Minimum Vmax (U/mg)"},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another.","title":"Evidence Method"},"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another."},{"name":"has_structure","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's.","title":"Has Structure"},"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's."},{"name":"has_sequence","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without.","title":"Has Sequence"},"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without."},{"name":"ec_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number.","title":"Ec Number"},"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number."},{"name":"min_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm.","title":"Min Tm"},"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm."},{"name":"max_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum melting temperature Tm (°C). See `min_tm`.","title":"Max Tm"},"description":"Maximum melting temperature Tm (°C). See `min_tm`."},{"name":"origin_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OriginType"},{"type":"null"}],"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Type"},"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422."},{"name":"origin_environment","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentType"},{"type":"null"}],"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Environment"},"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422."},{"name":"activity_class","in":"query","required":false,"schema":{"anyOf":[{"enum":["degrader","negative_only","inconclusive_only","mixed_nonpositive","untested","tested"],"type":"string"},{"type":"null"}],"title":"Activity Class"}},{"name":"kind","in":"query","required":false,"schema":{"enum":["wild_type","engineered","both"],"type":"string","description":"Which entities to export: 'wild_type', 'engineered' (variants), or 'both'. Engineered variants carry their derived sequence; their header is tagged 'engineered'.","default":"both","title":"Kind"},"description":"Which entities to export: 'wild_type', 'engineered' (variants), or 'both'. Engineered variants carry their derived sequence; their header is tagged 'engineered'."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/proteins.csv":{"get":{"tags":["downloads"],"summary":"Proteins Csv","description":"Download proteins as a streaming CSV file.","operationId":"proteins_csv_api_v1_downloads_proteins_csv_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"plasticdb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"}},{"name":"accession","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"}},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts.","title":"Microorganism"},"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts."},{"name":"lineage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"Filter by substrate form (vocabulary; unknown is a 422)","title":"Substrate Form"},"description":"Filter by substrate form (vocabulary; unknown is a 422)"},{"name":"include_negative","in":"query","required":false,"schema":{"type":"boolean","description":"Drop the result filter entirely and export every public record, negatives and untested entities included. This is the way back to an unfiltered export: with neither this nor `polarity`, the default is `positive`.","default":false,"title":"Include Negative"},"description":"Drop the result filter entirely and export every public record, negatives and untested entities included. This is the way back to an unfiltered export: with neither this nor `polarity`, the default is `positive`."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Filter by interaction result. **Defaults to `positive`** - an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider (proteins.csv 715 -> 685 rows; proteins.fasta 606 -> 584 records, the difference being entities with no sequence). Pass `include_negative=true` for every public record.","title":"Polarity"},"description":"Filter by interaction result. **Defaults to `positive`** - an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider (proteins.csv 715 -> 685 rows; proteins.fasta 606 -> 584 records, the difference being entities with no sequence). Pass `include_negative=true` for every public record."},{"name":"min_kcat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum kcat (s⁻¹)","title":"Min Kcat"},"description":"Minimum kcat (s⁻¹)"},{"name":"max_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum Km (mM)","title":"Max Km"},"description":"Maximum Km (mM)"},{"name":"min_kcat_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)","title":"Min Kcat Km"},"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)"},{"name":"min_vmax","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum Vmax (U/mg)","title":"Min Vmax"},"description":"Minimum Vmax (U/mg)"},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another.","title":"Evidence Method"},"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another."},{"name":"has_structure","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's.","title":"Has Structure"},"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's."},{"name":"has_sequence","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without.","title":"Has Sequence"},"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without."},{"name":"ec_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number.","title":"Ec Number"},"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number."},{"name":"min_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm.","title":"Min Tm"},"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm."},{"name":"max_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum melting temperature Tm (°C). See `min_tm`.","title":"Max Tm"},"description":"Maximum melting temperature Tm (°C). See `min_tm`."},{"name":"origin_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OriginType"},{"type":"null"}],"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Type"},"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422."},{"name":"origin_environment","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentType"},{"type":"null"}],"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Environment"},"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422."},{"name":"activity_class","in":"query","required":false,"schema":{"anyOf":[{"enum":["degrader","negative_only","inconclusive_only","mixed_nonpositive","untested","tested"],"type":"string"},{"type":"null"}],"title":"Activity Class"}},{"name":"kind","in":"query","required":false,"schema":{"enum":["wild_type","engineered","both"],"type":"string","description":"Which entities to export: 'wild_type', 'engineered' (variants), or 'both'. Engineered rows are tagged kind='engineered' and keyed by (kind, id); join protein-variants.csv on 'accession' for their mutations and engineering detail.","default":"both","title":"Kind"},"description":"Which entities to export: 'wild_type', 'engineered' (variants), or 'both'. Engineered rows are tagged kind='engineered' and keyed by (kind, id); join protein-variants.csv on 'accession' for their mutations and engineering detail."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/proteins.json":{"get":{"tags":["downloads"],"summary":"Proteins Json","description":"Download proteins as a streaming JSON array.","operationId":"proteins_json_api_v1_downloads_proteins_json_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"plasticdb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"}},{"name":"accession","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"}},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts.","title":"Microorganism"},"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts."},{"name":"lineage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"Filter by substrate form (vocabulary; unknown is a 422)","title":"Substrate Form"},"description":"Filter by substrate form (vocabulary; unknown is a 422)"},{"name":"include_negative","in":"query","required":false,"schema":{"type":"boolean","description":"Drop the result filter entirely and export every public record, negatives and untested entities included. This is the way back to an unfiltered export: with neither this nor `polarity`, the default is `positive`.","default":false,"title":"Include Negative"},"description":"Drop the result filter entirely and export every public record, negatives and untested entities included. This is the way back to an unfiltered export: with neither this nor `polarity`, the default is `positive`."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Filter by interaction result. **Defaults to `positive`** - an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider (proteins.csv 715 -> 685 rows; proteins.fasta 606 -> 584 records, the difference being entities with no sequence). Pass `include_negative=true` for every public record.","title":"Polarity"},"description":"Filter by interaction result. **Defaults to `positive`** - an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider (proteins.csv 715 -> 685 rows; proteins.fasta 606 -> 584 records, the difference being entities with no sequence). Pass `include_negative=true` for every public record."},{"name":"min_kcat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum kcat (s⁻¹)","title":"Min Kcat"},"description":"Minimum kcat (s⁻¹)"},{"name":"max_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum Km (mM)","title":"Max Km"},"description":"Maximum Km (mM)"},{"name":"min_kcat_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)","title":"Min Kcat Km"},"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)"},{"name":"min_vmax","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum Vmax (U/mg)","title":"Min Vmax"},"description":"Minimum Vmax (U/mg)"},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another.","title":"Evidence Method"},"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another."},{"name":"has_structure","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's.","title":"Has Structure"},"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's."},{"name":"has_sequence","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without.","title":"Has Sequence"},"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without."},{"name":"ec_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number.","title":"Ec Number"},"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number."},{"name":"min_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm.","title":"Min Tm"},"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm."},{"name":"max_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum melting temperature Tm (°C). See `min_tm`.","title":"Max Tm"},"description":"Maximum melting temperature Tm (°C). See `min_tm`."},{"name":"origin_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OriginType"},{"type":"null"}],"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Type"},"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422."},{"name":"origin_environment","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentType"},{"type":"null"}],"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Environment"},"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422."},{"name":"activity_class","in":"query","required":false,"schema":{"anyOf":[{"enum":["degrader","negative_only","inconclusive_only","mixed_nonpositive","untested","tested"],"type":"string"},{"type":"null"}],"title":"Activity Class"}},{"name":"kind","in":"query","required":false,"schema":{"enum":["wild_type","engineered","both"],"type":"string","description":"Which entities to export: 'wild_type', 'engineered' (variants), or 'both'. Engineered rows are tagged kind='engineered' and keyed by (kind, id); join protein-variants.json on 'accession' for their mutations and engineering detail.","default":"both","title":"Kind"},"description":"Which entities to export: 'wild_type', 'engineered' (variants), or 'both'. Engineered rows are tagged kind='engineered' and keyed by (kind, id); join protein-variants.json on 'accession' for their mutations and engineering detail."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/microorganisms.csv":{"get":{"tags":["downloads"],"summary":"Microorganisms Csv","description":"Download microorganisms as a streaming CSV file.","operationId":"microorganisms_csv_api_v1_downloads_microorganisms_csv_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"tax_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"}},{"name":"temp_class","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TempClass"},{"type":"null"}],"description":"Growth-temperature class from the organism's recorded optimum growth temperature (`growth_temp_opt`): psychrophile (<20 °C), mesophile (20–45 °C) or thermophile (≥45 °C). Not the assay temperature; organisms with no recorded optimum match none of the three. An unknown value is a 422.","title":"Temp Class"},"description":"Growth-temperature class from the organism's recorded optimum growth temperature (`growth_temp_opt`): psychrophile (<20 °C), mesophile (20–45 °C) or thermophile (≥45 °C). Not the assay temperature; organisms with no recorded optimum match none of the three. An unknown value is a 422."},{"name":"environment","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"}},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"lineage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"kingdom","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kingdom"}},{"name":"phylum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phylum"}},{"name":"class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Class"}},{"name":"order","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order"}},{"name":"family","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"}},{"name":"genus","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genus"}},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"title":"Evidence Method"}},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"Filter by substrate form (vocabulary; unknown is a 422)","title":"Substrate Form"},"description":"Filter by substrate form (vocabulary; unknown is a 422)"},{"name":"sole_carbon_source","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SoleCarbonSource"},{"type":"null"}],"description":"Assay condition: was the plastic the sole carbon source? 'yes', 'no', or 'not_stated' (the paper does not say). Applied to the same credited experiment as `evidence_method`/`substrate_form`/`aerobicity`, under `evidence_scope`.","title":"Sole Carbon Source"},"description":"Assay condition: was the plastic the sole carbon source? 'yes', 'no', or 'not_stated' (the paper does not say). Applied to the same credited experiment as `evidence_method`/`substrate_form`/`aerobicity`, under `evidence_scope`."},{"name":"aerobicity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Aerobicity"},{"type":"null"}],"description":"Assay condition: 'aerobic', 'anaerobic', 'microaerophilic' or 'not_reported' (also matches experiments with no value). Applied to the same credited experiment as the other assay filters.","title":"Aerobicity"},"description":"Assay condition: 'aerobic', 'anaerobic', 'microaerophilic' or 'not_reported' (also matches experiments with no value). Applied to the same credited experiment as the other assay filters."},{"name":"include_negative","in":"query","required":false,"schema":{"type":"boolean","description":"Include negative-result interactions","default":false,"title":"Include Negative"},"description":"Include negative-result interactions"},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Filter by interaction result","title":"Polarity"},"description":"Filter by interaction result"},{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/EvidenceScope","description":"Which evidence credits an organism: 'organism_or_enzyme' (default — it was assayed whole OR an enzyme purified from it was; the site-wide reading, inherited from PlasticDB v1), 'whole_organism' (assayed whole only), or 'enzyme_only' (credited solely through one of its enzymes). The last two partition the first.","default":"organism_or_enzyme"},"description":"Which evidence credits an organism: 'organism_or_enzyme' (default — it was assayed whole OR an enzyme purified from it was; the site-wide reading, inherited from PlasticDB v1), 'whole_organism' (assayed whole only), or 'enzyme_only' (credited solely through one of its enzymes). The last two partition the first."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/microorganisms.json":{"get":{"tags":["downloads"],"summary":"Microorganisms Json","description":"Download microorganisms as a streaming JSON array.","operationId":"microorganisms_json_api_v1_downloads_microorganisms_json_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"tax_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"}},{"name":"temp_class","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TempClass"},{"type":"null"}],"description":"Growth-temperature class from the organism's recorded optimum growth temperature (`growth_temp_opt`): psychrophile (<20 °C), mesophile (20–45 °C) or thermophile (≥45 °C). Not the assay temperature; organisms with no recorded optimum match none of the three. An unknown value is a 422.","title":"Temp Class"},"description":"Growth-temperature class from the organism's recorded optimum growth temperature (`growth_temp_opt`): psychrophile (<20 °C), mesophile (20–45 °C) or thermophile (≥45 °C). Not the assay temperature; organisms with no recorded optimum match none of the three. An unknown value is a 422."},{"name":"environment","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"}},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"lineage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"kingdom","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kingdom"}},{"name":"phylum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phylum"}},{"name":"class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Class"}},{"name":"order","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order"}},{"name":"family","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"}},{"name":"genus","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genus"}},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"title":"Evidence Method"}},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"Filter by substrate form (vocabulary; unknown is a 422)","title":"Substrate Form"},"description":"Filter by substrate form (vocabulary; unknown is a 422)"},{"name":"sole_carbon_source","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SoleCarbonSource"},{"type":"null"}],"description":"Assay condition: was the plastic the sole carbon source? 'yes', 'no', or 'not_stated' (the paper does not say). Applied to the same credited experiment as `evidence_method`/`substrate_form`/`aerobicity`, under `evidence_scope`.","title":"Sole Carbon Source"},"description":"Assay condition: was the plastic the sole carbon source? 'yes', 'no', or 'not_stated' (the paper does not say). Applied to the same credited experiment as `evidence_method`/`substrate_form`/`aerobicity`, under `evidence_scope`."},{"name":"aerobicity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Aerobicity"},{"type":"null"}],"description":"Assay condition: 'aerobic', 'anaerobic', 'microaerophilic' or 'not_reported' (also matches experiments with no value). Applied to the same credited experiment as the other assay filters.","title":"Aerobicity"},"description":"Assay condition: 'aerobic', 'anaerobic', 'microaerophilic' or 'not_reported' (also matches experiments with no value). Applied to the same credited experiment as the other assay filters."},{"name":"include_negative","in":"query","required":false,"schema":{"type":"boolean","description":"Include negative-result interactions","default":false,"title":"Include Negative"},"description":"Include negative-result interactions"},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Filter by interaction result","title":"Polarity"},"description":"Filter by interaction result"},{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/EvidenceScope","description":"Which evidence credits an organism: 'organism_or_enzyme' (default — it was assayed whole OR an enzyme purified from it was; the site-wide reading, inherited from PlasticDB v1), 'whole_organism' (assayed whole only), or 'enzyme_only' (credited solely through one of its enzymes). The last two partition the first.","default":"organism_or_enzyme"},"description":"Which evidence credits an organism: 'organism_or_enzyme' (default — it was assayed whole OR an enzyme purified from it was; the site-wide reading, inherited from PlasticDB v1), 'whole_organism' (assayed whole only), or 'enzyme_only' (credited solely through one of its enzymes). The last two partition the first."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/plastics.csv":{"get":{"tags":["downloads"],"summary":"Plastics Csv","description":"Download plastics as a streaming CSV file.","operationId":"plastics_csv_api_v1_downloads_plastics_csv_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"cas_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cas Number"}},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"polymer_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Polymer Class"}},{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"}},{"name":"has_evidence","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only plastics with at least one degrading microorganism or protein; `false`: only those with none.","title":"Has Evidence"},"description":"`true`: only plastics with at least one degrading microorganism or protein; `false`: only those with none."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/plastics.json":{"get":{"tags":["downloads"],"summary":"Plastics Json","description":"Download plastics as a streaming JSON array.","operationId":"plastics_json_api_v1_downloads_plastics_json_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"cas_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cas Number"}},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"polymer_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Polymer Class"}},{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"}},{"name":"has_evidence","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only plastics with at least one degrading microorganism or protein; `false`: only those with none.","title":"Has Evidence"},"description":"`true`: only plastics with at least one degrading microorganism or protein; `false`: only those with none."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/papers.csv":{"get":{"tags":["downloads"],"summary":"Papers Csv","description":"Download papers as a streaming CSV file.","operationId":"papers_csv_api_v1_downloads_papers_csv_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"}},{"name":"journal","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal"}},{"name":"authors","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authors"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Corresponding-author country","title":"Country"},"description":"Corresponding-author country"},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'.","title":"Plastic"},"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope).","title":"Microorganism"},"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope)."},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this protein (or variant) accession.","title":"Protein"},"description":"Papers with evidence on this protein (or variant) accession."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Papers with at least one experiment using this method.","title":"Evidence Method"},"description":"Papers with at least one experiment using this method."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches.","title":"Polarity"},"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches."},{"name":"result","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","title":"Result"},"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","deprecated":true},{"name":"has_quantitative","in":"query","required":false,"schema":{"type":"boolean","description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss).","default":false,"title":"Has Quantitative"},"description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/papers.json":{"get":{"tags":["downloads"],"summary":"Papers Json","description":"Download papers as a streaming JSON array.","operationId":"papers_json_api_v1_downloads_papers_json_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"}},{"name":"journal","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal"}},{"name":"authors","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authors"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Corresponding-author country","title":"Country"},"description":"Corresponding-author country"},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'.","title":"Plastic"},"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope).","title":"Microorganism"},"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope)."},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this protein (or variant) accession.","title":"Protein"},"description":"Papers with evidence on this protein (or variant) accession."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Papers with at least one experiment using this method.","title":"Evidence Method"},"description":"Papers with at least one experiment using this method."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches.","title":"Polarity"},"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches."},{"name":"result","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","title":"Result"},"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","deprecated":true},{"name":"has_quantitative","in":"query","required":false,"schema":{"type":"boolean","description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss).","default":false,"title":"Has Quantitative"},"description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/protein-variants.csv":{"get":{"tags":["downloads"],"summary":"Protein Variants Csv","description":"Download protein variants as a streaming CSV file.","operationId":"protein_variants_csv_api_v1_downloads_protein_variants_csv_get","parameters":[{"name":"parent_protein_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Protein Id"}},{"name":"parent_plasticdb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Plasticdb Id"}},{"name":"variant_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Type"}},{"name":"engineering_method","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engineering Method"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/protein-variants.json":{"get":{"tags":["downloads"],"summary":"Protein Variants Json","description":"Download protein variants as a streaming JSON array.","operationId":"protein_variants_json_api_v1_downloads_protein_variants_json_get","parameters":[{"name":"parent_protein_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Protein Id"}},{"name":"parent_plasticdb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Plasticdb Id"}},{"name":"variant_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Type"}},{"name":"engineering_method","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engineering Method"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}},"X-PlasticDB-Source-SHA256":{"description":"On a past-release download: the SHA-256 of the release Parquet artefact(s) the file is rendered from, as listed in its MANIFEST.json (FASTA: proteins then protein_variants, comma-separated).","schema":{"type":"string"}},"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"304":{"description":"A past release's download whose `If-None-Match` matches its `ETag`: no body.","headers":{"ETag":{"description":"On a past-release download: a weak validator, the same for every download of that release and format (`If-None-Match` answers 304).","schema":{"type":"string"}},"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/downloads/search.zip":{"get":{"tags":["downloads"],"summary":"Search Zip","operationId":"search_zip_api_v1_downloads_search_zip_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/downloads/search.json":{"get":{"tags":["downloads"],"summary":"Search Json","operationId":"search_json_api_v1_downloads_search_json_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/microorganisms/names":{"get":{"tags":["microorganisms"],"summary":"List Microorganism Names","description":"Return every publicly visible microorganism as {id, name} for dropdowns.","operationId":"list_microorganism_names_api_v1_microorganisms_names_get","parameters":[{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MicroorganismOption"},"title":"Response List Microorganism Names Api V1 Microorganisms Names Get"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/microorganisms/search":{"get":{"tags":["microorganisms"],"summary":"Search Microorganisms","description":"Autocomplete search with tsvector + trigram fuzzy matching.","operationId":"search_microorganisms_api_v1_microorganisms_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MicroorganismOption"},"title":"Response Search Microorganisms Api V1 Microorganisms Search Get"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/microorganisms/lineage-levels":{"get":{"tags":["microorganisms"],"summary":"Get Lineage Levels","operationId":"get_lineage_levels_api_v1_microorganisms_lineage_levels_get","parameters":[{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"kingdom","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kingdom"}},{"name":"phylum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phylum"}},{"name":"class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Class"}},{"name":"order","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order"}},{"name":"family","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LineageLevels"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/microorganisms":{"get":{"tags":["microorganisms"],"summary":"List Microorganisms","operationId":"list_microorganisms_api_v1_microorganisms_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"tax_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tax Id"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"temp_class","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TempClass"},{"type":"null"}],"description":"Growth-temperature class from the organism's recorded optimum growth temperature (`growth_temp_opt`): psychrophile (<20 °C), mesophile (20–45 °C) or thermophile (≥45 °C). Not the assay temperature; organisms with no recorded optimum match none of the three. An unknown value is a 422.","title":"Temp Class"},"description":"Growth-temperature class from the organism's recorded optimum growth temperature (`growth_temp_opt`): psychrophile (<20 °C), mesophile (20–45 °C) or thermophile (≥45 °C). Not the assay temperature; organisms with no recorded optimum match none of the three. An unknown value is a 422."},{"name":"environment","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"}},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"lineage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"kingdom","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kingdom"}},{"name":"phylum","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phylum"}},{"name":"class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Class"}},{"name":"order","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order"}},{"name":"family","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family"}},{"name":"genus","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genus"}},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Assay method, matched exactly against the method vocabulary (e.g. 'co2_evolution', 'weight_loss', 'gpc_sec'). An unknown method is a 422.","title":"Evidence Method"},"description":"Assay method, matched exactly against the method vocabulary (e.g. 'co2_evolution', 'weight_loss', 'gpc_sec'). An unknown method is a 422."},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"Substrate form as tested (e.g. 'film', 'powder'), from the controlled vocabulary. An unknown form is a 422.","title":"Substrate Form"},"description":"Substrate form as tested (e.g. 'film', 'powder'), from the controlled vocabulary. An unknown form is a 422."},{"name":"sole_carbon_source","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SoleCarbonSource"},{"type":"null"}],"description":"Assay condition: was the plastic the sole carbon source? 'yes', 'no', or 'not_stated' (the paper does not say). Applied to the same credited experiment as `evidence_method`/`substrate_form`/`aerobicity`, under `evidence_scope`.","title":"Sole Carbon Source"},"description":"Assay condition: was the plastic the sole carbon source? 'yes', 'no', or 'not_stated' (the paper does not say). Applied to the same credited experiment as `evidence_method`/`substrate_form`/`aerobicity`, under `evidence_scope`."},{"name":"aerobicity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Aerobicity"},{"type":"null"}],"description":"Assay condition: 'aerobic', 'anaerobic', 'microaerophilic' or 'not_reported' (also matches experiments with no value). Applied to the same credited experiment as the other assay filters.","title":"Aerobicity"},"description":"Assay condition: 'aerobic', 'anaerobic', 'microaerophilic' or 'not_reported' (also matches experiments with no value). Applied to the same credited experiment as the other assay filters."},{"name":"include_negative","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Negative"}},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"title":"Polarity"}},{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/EvidenceScope","description":"Which evidence credits an organism: 'organism_or_enzyme' (default — it was assayed whole OR an enzyme purified from it was; the site-wide reading, inherited from PlasticDB v1), 'whole_organism' (assayed whole only), or 'enzyme_only' (credited solely through one of its enzymes). The last two partition the first.","default":"organism_or_enzyme"},"description":"Which evidence credits an organism: 'organism_or_enzyme' (default — it was assayed whole OR an enzyme purified from it was; the site-wide reading, inherited from PlasticDB v1), 'whole_organism' (assayed whole only), or 'enzyme_only' (credited solely through one of its enzymes). The last two partition the first."},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["name","tax_id","growth_temp_opt","id"],"type":"string","description":"Sort key. Ties always break by `id`, so offset paging is stable.","default":"name","title":"Sort By"},"description":"Sort key. Ties always break by `id`, so offset paging is stable."},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"asc","title":"Sort Order"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those.","title":"Updated Since"},"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_MicroorganismListItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/microorganisms/accession/{accession}":{"get":{"tags":["microorganisms"],"summary":"Get Microorganism By Accession","description":"The same detail, addressed by PlasticDB accession rather than tax-id.","operationId":"get_microorganism_by_accession_api_v1_microorganisms_accession__accession__get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/EvidenceScope","description":"Which evidence credits the organism on this record: 'organism_or_enzyme' (default — its own whole-organism assays plus those of enzymes purified from it), 'whole_organism' (its own assays only) or 'enzyme_only' (only its enzymes' assays). The last two partition the first. Any other value is a 422.","default":"organism_or_enzyme"},"description":"Which evidence credits the organism on this record: 'organism_or_enzyme' (default — its own whole-organism assays plus those of enzymes purified from it), 'whole_organism' (its own assays only) or 'enzyme_only' (only its enzymes' assays). The last two partition the first. Any other value is a 422."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MicroorganismDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/microorganisms/{ref}":{"get":{"tags":["microorganisms"],"summary":"Get Microorganism","description":"One organism, by NCBI tax-id **or** PlasticDB accession.","operationId":"get_microorganism_api_v1_microorganisms__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}},{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/EvidenceScope","description":"Which evidence credits the organism on this record: 'organism_or_enzyme' (default — its own whole-organism assays plus those of enzymes purified from it), 'whole_organism' (its own assays only) or 'enzyme_only' (only its enzymes' assays). The last two partition the first. Any other value is a 422.","default":"organism_or_enzyme"},"description":"Which evidence credits the organism on this record: 'organism_or_enzyme' (default — its own whole-organism assays plus those of enzymes purified from it), 'whole_organism' (its own assays only) or 'enzyme_only' (only its enzymes' assays). The last two partition the first. Any other value is a 422."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MicroorganismDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/microorganisms/taxonomy/{rank}/{name}":{"get":{"tags":["microorganisms"],"summary":"Get Taxonomy Group","description":"Aggregate stats for a taxonomic group.","operationId":"get_taxonomy_group_api_v1_microorganisms_taxonomy__rank___name__get","parameters":[{"name":"rank","in":"path","required":true,"schema":{"type":"string","title":"Rank"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxonomyGroupStats"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"302":{"description":"A renamed taxon: redirect to its successor."},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compounds":{"get":{"tags":["compounds"],"summary":"List Compounds","operationId":"list_compounds_api_v1_compounds_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search by name","title":"Q"},"description":"Search by name"},{"name":"is_additive","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by additive status","title":"Is Additive"},"description":"Filter by additive status"},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["name","formula","is_additive","id"],"type":"string","description":"Sort key. Ties always break by `id`, so offset paging is stable.","default":"name","title":"Sort By"},"description":"Sort key. Ties always break by `id`, so offset paging is stable."},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"asc","title":"Sort Order"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_CompoundRead_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compounds/{compound_id}":{"get":{"tags":["compounds"],"summary":"Get Compound","operationId":"get_compound_api_v1_compounds__compound_id__get","parameters":[{"name":"compound_id","in":"path","required":true,"schema":{"type":"integer","title":"Compound Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompoundDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/plastics/names":{"get":{"tags":["plastics"],"summary":"List Plastic Names","operationId":"list_plastic_names_api_v1_plastics_names_get","parameters":[{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlasticOption"},"title":"Response List Plastic Names Api V1 Plastics Names Get"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/plastics":{"get":{"tags":["plastics"],"summary":"List Plastics","operationId":"list_plastics_api_v1_plastics_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"cas_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cas Number"}},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"polymer_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Polymer Class"}},{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Id"}},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["name","full_name","cas_number","microorganism_count","protein_count","id"],"type":"string","description":"'name', 'full_name', 'cas_number', 'microorganism_count', 'protein_count' (the degrader counts shown per row; ties break by name) or 'id'. The final tiebreaker is always `id`, so offset paging is stable.","default":"name","title":"Sort By"},"description":"'name', 'full_name', 'cas_number', 'microorganism_count', 'protein_count' (the degrader counts shown per row; ties break by name) or 'id'. The final tiebreaker is always `id`, so offset paging is stable."},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"asc","title":"Sort Order"}},{"name":"has_evidence","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only plastics with at least one degrading microorganism or protein (a positive result); `false`: only those with none — not studied, or tested only with negative/inconclusive results.","title":"Has Evidence"},"description":"`true`: only plastics with at least one degrading microorganism or protein (a positive result); `false`: only those with none — not studied, or tested only with negative/inconclusive results."},{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/RowEvidenceScope","description":"Organism degradation evidence: 'organism_or_enzyme' (default, credits an organism whose enzyme degrades the plastic) or 'whole_organism'. Any other value is a 422.","default":"organism_or_enzyme"},"description":"Organism degradation evidence: 'organism_or_enzyme' (default, credits an organism whose enzyme degrades the plastic) or 'whole_organism'. Any other value is a 422."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those.","title":"Updated Since"},"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_PlasticListItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/plastics/{plastic_id}":{"get":{"tags":["plastics"],"summary":"Get Plastic","description":"One polymer with its degraders and enzymes.","operationId":"get_plastic_api_v1_plastics__plastic_id__get","parameters":[{"name":"plastic_id","in":"path","required":true,"schema":{"type":"integer","title":"Plastic Id"}},{"name":"microorganism_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Microorganism Offset"}},{"name":"microorganism_limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":25,"title":"Microorganism Limit"}},{"name":"protein_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Protein Offset"}},{"name":"protein_limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":25,"title":"Protein Limit"}},{"name":"microorganism_sort_by","in":"query","required":false,"schema":{"enum":["papers","result","name"],"type":"string","default":"papers","title":"Microorganism Sort By"}},{"name":"microorganism_sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Microorganism Sort Order"}},{"name":"protein_sort_by","in":"query","required":false,"schema":{"enum":["papers","result","plasticdb_id","accession","name","id"],"type":"string","default":"id","title":"Protein Sort By"}},{"name":"protein_sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Protein Sort Order"}},{"name":"microorganism_polarity","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ResultEnum","description":"Which bucket of organisms to page: the best result each has on this plastic.","default":"positive"},"description":"Which bucket of organisms to page: the best result each has on this plastic."},{"name":"protein_polarity","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ResultEnum","description":"Which bucket of proteins to page: the best result each has on this plastic.","default":"positive"},"description":"Which bucket of proteins to page: the best result each has on this plastic."},{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/RowEvidenceScope","default":"organism_or_enzyme"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlasticDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins":{"get":{"tags":["proteins"],"summary":"List Proteins","operationId":"list_proteins_api_v1_proteins_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query. Also matches an identifier exactly (PB accession, plasticdb_id, UniProt, GenBank with or without its version, PDB), and those hits rank first.","title":"Q"},"description":"Full-text search query. Also matches an identifier exactly (PB accession, plasticdb_id, UniProt, GenBank with or without its version, PDB), and those hits rank first."},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"plasticdb_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plasticdb Id"}},{"name":"accession","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"}},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts.","title":"Microorganism"},"description":"Proteins whose source organism is this one: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (case-insensitive substring) — the same terms `/papers?microorganism=` accepts."},{"name":"lineage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lineage"}},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"Substrate form as tested (e.g. 'film', 'powder'), from the controlled vocabulary. An unknown form is a 422.","title":"Substrate Form"},"description":"Substrate form as tested (e.g. 'film', 'powder'), from the controlled vocabulary. An unknown form is a 422."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another. An unknown method is a 422.","title":"Evidence Method"},"description":"Filter by the assay method backing the evidence, matched exactly against the method vocabulary (e.g. 'weight_loss', 'hplc', 'sem', 'clear_zone'). No method ranks above another. An unknown method is a 422."},{"name":"include_negative","in":"query","required":false,"schema":{"type":"boolean","description":"Drop the result filter entirely and return every public record, negatives and untested entities included. This is the way back to an unfiltered list: with neither this nor `polarity`, the default is `positive`.","default":false,"title":"Include Negative"},"description":"Drop the result filter entirely and return every public record, negatives and untested entities included. This is the way back to an unfiltered list: with neither this nor `polarity`, the default is `positive`."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Filter by interaction result. **Defaults to `positive`** — an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider and matched no surface on the site. Pass `include_negative=true` for every public record.","title":"Polarity"},"description":"Filter by interaction result. **Defaults to `positive`** — an entity with at least one positive result, the same question the landing page's Proteins count answers. Until 0.84.3 the default was 'anything except an entity whose evidence is exclusively negative', which was 30 records wider and matched no surface on the site. Pass `include_negative=true` for every public record."},{"name":"activity_class","in":"query","required":false,"schema":{"anyOf":[{"enum":["degrader","negative_only","inconclusive_only","mixed_nonpositive","untested","tested"],"type":"string"},{"type":"null"}],"description":"Own recorded plastic-assay evidence across all plastics; negative_only excludes any positive or inconclusive result. Explicit selection overrides the default positive filter.","title":"Activity Class"},"description":"Own recorded plastic-assay evidence across all plastics; negative_only excludes any positive or inconclusive result. Explicit selection overrides the default positive filter."},{"name":"min_kcat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum kcat (s⁻¹)","title":"Min Kcat"},"description":"Minimum kcat (s⁻¹)"},{"name":"max_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum Km (mM)","title":"Max Km"},"description":"Maximum Km (mM)"},{"name":"min_kcat_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)","title":"Min Kcat Km"},"description":"Minimum catalytic efficiency kcat/Km (M⁻¹·s⁻¹)"},{"name":"min_vmax","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum Vmax (U/mg)","title":"Min Vmax"},"description":"Minimum Vmax (U/mg)"},{"name":"has_structure","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's.","title":"Has Structure"},"description":"`true`: only entities with their own experimentally determined structure (a PDB entry; predicted AlphaFold/ESMFold models do not count). `false`: only those without one. A variant is judged on its own structure, not its parent's."},{"name":"has_sequence","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without.","title":"Has Sequence"},"description":"`true`: only entities with a stored amino-acid sequence; `false`: only those without."},{"name":"include_sequenceless","in":"query","required":false,"schema":{"type":"boolean","description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence.","default":false,"title":"Include Sequenceless"},"description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence."},{"name":"ec_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number.","title":"Ec Number"},"description":"EC number prefix, matched on whole levels: `3.1.1` matches 3.1.1.101 and 3.1.1.- but not 3.1.10.x. A variant inherits its parent's EC number."},{"name":"min_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm.","title":"Min Tm"},"description":"Minimum melting temperature Tm (°C), from the stored enzyme properties. An engineered variant is judged on its own Tm."},{"name":"max_tm","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum melting temperature Tm (°C). See `min_tm`.","title":"Max Tm"},"description":"Maximum melting temperature Tm (°C). See `min_tm`."},{"name":"origin_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OriginType"},{"type":"null"}],"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Type"},"description":"How the enzyme's sequence was obtained (e.g. 'environmental_isolate', 'metagenome'). A variant matches on its parent's origin. An unknown value is a 422."},{"name":"origin_environment","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentType"},{"type":"null"}],"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422.","title":"Origin Environment"},"description":"Environment type the enzyme's origin sample came from (e.g. 'compost', 'marine_sediment'), matched exactly. A variant matches on its parent's origin. An unknown value is a 422."},{"name":"include_sequence","in":"query","required":false,"schema":{"type":"boolean","description":"`true`: add each item's amino-acid `sequence` (a variant's own). Off by default, so the list stays small.","default":false,"title":"Include Sequence"},"description":"`true`: add each item's amino-acid `sequence` (a variant's own). Off by default, so the list stays small."},{"name":"kind","in":"query","required":false,"schema":{"enum":["wild_type","engineered","both"],"type":"string","description":"Which protein entities to list: 'wild_type', 'engineered' (variants), or 'both'. An unrecognised value is a 422 — it used to fall back to 'both', which silently answered a typo with the wrong dataset.","default":"both","title":"Kind"},"description":"Which protein entities to list: 'wild_type', 'engineered' (variants), or 'both'. An unrecognised value is a 422 — it used to fall back to 'both', which silently answered a typo with the wrong dataset."},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["year","name","accession","id","plasticdb_id","genbank_id"],"type":"string","description":"Sort key. Ties always break by a unique key, so offset paging is stable. `plasticdb_id` and `genbank_id` need `kind=wild_type`.","default":"year","title":"Sort By"},"description":"Sort key. Ties always break by a unique key, so offset paging is stable. `plasticdb_id` and `genbank_id` need `kind=wild_type`."},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Sort Order"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those.","title":"Updated Since"},"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ProteinListSequenceItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins/accession/{accession}":{"get":{"tags":["proteins"],"summary":"Get Protein By Accession","description":"Look up a protein by PB#### accession (case-insensitive).","operationId":"get_protein_by_accession_api_v1_proteins_accession__accession__get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProteinAccessionLookup"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/proteins/{accession}":{"get":{"tags":["proteins"],"summary":"Get Protein","description":"Look up a protein by PB#### accession (case-insensitive) or numeric id,\nas `/fasta` and `/structure` do.","operationId":"get_protein_api_v1_proteins__accession__get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"view","in":"query","required":false,"schema":{"enum":["full","summary"],"type":"string","description":"`summary` (default since 2.89.0): the record without its per-record evidence lists (`interactions`, `indirect_interactions`, `variants`, `kinetics`, `properties`), which are replaced by a `counts` object; page them from `/interactions`, `/variants`, `/kinetics` and `/properties`. `full`: the whole record, evidence rows included.","default":"summary","title":"View"},"description":"`summary` (default since 2.89.0): the record without its per-record evidence lists (`interactions`, `indirect_interactions`, `variants`, `kinetics`, `properties`), which are replaced by a `counts` object; page them from `/interactions`, `/variants`, `/kinetics` and `/properties`. `full`: the whole record, evidence rows included."},{"name":"include_sequenceless","in":"query","required":false,"schema":{"type":"boolean","description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence.","default":false,"title":"Include Sequenceless"},"description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProteinDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins/{accession}/variants":{"get":{"tags":["proteins"],"summary":"List Protein Variants","description":"One page of this protein's engineered variants (the detail's ``variants``).","operationId":"list_protein_variants_api_v1_proteins__accession__variants_get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"include_sequenceless","in":"query","required":false,"schema":{"type":"boolean","description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence.","default":false,"title":"Include Sequenceless"},"description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ProteinVariantRead_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"404":{"description":"No such protein; or an engineered variant (`reason: engineered_variant`, `location`: its record), which has none of these sub-resources; or an unknown release (`reason`)."},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins/{accession}/interactions":{"get":{"tags":["proteins"],"summary":"List Protein Interactions","description":"One page of this protein's evidence (the detail's interaction lists).","operationId":"list_protein_interactions_api_v1_proteins__accession__interactions_get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"evidence_level","in":"query","required":false,"schema":{"anyOf":[{"enum":["all","direct","indirect"],"type":"string"},{"type":"null"}],"description":"`direct`: evidence recorded on the protein itself (the detail's `interactions`). `indirect`: evidence credited through its engineered variants (`indirect_interactions`), each labelled with its variant. `all` (default): direct first, then indirect.","title":"Evidence Level"},"description":"`direct`: evidence recorded on the protein itself (the detail's `interactions`). `indirect`: evidence credited through its engineered variants (`indirect_interactions`), each labelled with its variant. `all` (default): direct first, then indirect."},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"enum":["all","direct","indirect"],"type":"string"},{"type":"null"}],"description":"Deprecated alias of `evidence_level` (the name the top-level evidence lists use). Different values in both is a 422.","title":"Kind"},"description":"Deprecated alias of `evidence_level` (the name the top-level evidence lists use). Different values in both is a 422.","deprecated":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"include_sequenceless","in":"query","required":false,"schema":{"type":"boolean","description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence.","default":false,"title":"Include Sequenceless"},"description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_InteractionRead_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"404":{"description":"No such protein; or an engineered variant (`reason: engineered_variant`, `location`: its record), which has none of these sub-resources; or an unknown release (`reason`)."},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins/{accession}/kinetics":{"get":{"tags":["proteins"],"summary":"List Protein Kinetics","description":"One page of this protein's kinetic measurements (the detail's `kinetics`).","operationId":"list_protein_kinetics_api_v1_proteins__accession__kinetics_get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"include_sequenceless","in":"query","required":false,"schema":{"type":"boolean","description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence.","default":false,"title":"Include Sequenceless"},"description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_EnzymeKineticsRead_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"404":{"description":"No such protein; or an engineered variant (`reason: engineered_variant`, `location`: its record), which has none of these sub-resources; or an unknown release (`reason`)."},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins/{accession}/properties":{"get":{"tags":["proteins"],"summary":"List Protein Properties","description":"One page of this protein's stability/optima rows (the detail's `properties`).","operationId":"list_protein_properties_api_v1_proteins__accession__properties_get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"include_sequenceless","in":"query","required":false,"schema":{"type":"boolean","description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence.","default":false,"title":"Include Sequenceless"},"description":"Also list proteins and engineered variants that have no amino-acid sequence (and their interactions), which every public surface hides by default. A record reappears on its own once it gets a sequence."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_EnzymePropertiesRead_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"404":{"description":"No such protein; or an engineered variant (`reason: engineered_variant`, `location`: its record), which has none of these sub-resources; or an unknown release (`reason`)."},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins/{ref}/fasta":{"get":{"tags":["proteins"],"summary":"Get Protein Fasta","description":"This protein's sequence, by numeric id or PB#### accession.","operationId":"get_protein_fasta_api_v1_proteins__ref__fasta_get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/proteins/{ref}/structure":{"get":{"tags":["proteins"],"summary":"Get Protein Structure","description":"Coordinates for the 3D viewer, by numeric id or PB#### accession.","operationId":"get_protein_structure_api_v1_proteins__ref__structure_get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/engineering/proteins":{"get":{"tags":["engineering"],"summary":"List Engineering Proteins","operationId":"list_engineering_proteins_api_v1_engineering_proteins_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those.","title":"Updated Since"},"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ProteinListItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/engineering/proteins/{accession}":{"get":{"tags":["engineering"],"summary":"Get Engineering Lineage","operationId":"get_engineering_lineage_api_v1_engineering_proteins__accession__get","parameters":[{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EngineeringLineage"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/variants/{ref}":{"get":{"tags":["variants"],"summary":"Get Variant","description":"Return one engineered variant with its mutations, kinetics, stability, parent protein,\nsource paper and the plastics it is reported to act on.","operationId":"get_variant_api_v1_variants__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}},{"name":"include_sequenceless","in":"query","required":false,"schema":{"type":"boolean","description":"Also resolve a variant that is hidden for having no sequence (or whose parent has none). The protein search's opt-in.","default":false,"title":"Include Sequenceless"},"description":"Also resolve a variant that is hidden for having no sequence (or whose parent has none). The protein search's opt-in."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VariantDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/variants/{ref}/fasta":{"get":{"tags":["variants"],"summary":"Get Variant Fasta","description":"This variant's own sequence as FASTA, by numeric id or accession.","operationId":"get_variant_fasta_api_v1_variants__ref__fasta_get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/variants/{ref}/structure":{"get":{"tags":["variants"],"summary":"Get Variant Structure","description":"This variant's own coordinates, for the 3D viewer on its page.","operationId":"get_variant_structure_api_v1_variants__ref__structure_get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"301":{"description":"Merged into another record, or an engineered variant asked for at /proteins; follow `Location`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordRedirect"}}}},"410":{"description":"Withdrawn.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordGoneBody"}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/constructs":{"get":{"tags":["preparations"],"summary":"Constructs","operationId":"constructs_api_v1_constructs_get","parameters":[{"name":"protein_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"}},{"name":"protein_variant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"}},{"name":"paper_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"}},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead.","title":"Protein"},"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead."},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring of the paper's DOI, as on `/papers`.","title":"Doi"},"description":"Case-insensitive substring of the paper's DOI, as on `/papers`."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConstructPage"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/constructs/{construct_id}":{"get":{"tags":["preparations"],"summary":"Construct","operationId":"construct_api_v1_constructs__construct_id__get","parameters":[{"name":"construct_id","in":"path","required":true,"schema":{"type":"integer","title":"Construct Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProteinConstructDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/preparations":{"get":{"tags":["preparations"],"summary":"Preparations","operationId":"preparations_api_v1_preparations_get","parameters":[{"name":"protein_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"}},{"name":"protein_variant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"}},{"name":"paper_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"}},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead.","title":"Protein"},"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead."},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring of the paper's DOI, as on `/papers`.","title":"Doi"},"description":"Case-insensitive substring of the paper's DOI, as on `/papers`."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreparationPage"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/preparations/{preparation_id}":{"get":{"tags":["preparations"],"summary":"Preparation","operationId":"preparation_api_v1_preparations__preparation_id__get","parameters":[{"name":"preparation_id","in":"path","required":true,"schema":{"type":"integer","title":"Preparation Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnzymePreparationDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/experiments/{experiment_id}/preparations":{"get":{"tags":["preparations"],"summary":"Experiment Preparations","operationId":"experiment_preparations_api_v1_experiments__experiment_id__preparations_get","parameters":[{"name":"experiment_id","in":"path","required":true,"schema":{"type":"integer","title":"Experiment Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentPreparationList"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/constructs/{construct_id}/structures":{"get":{"tags":["preparations"],"summary":"Construct Structures","operationId":"construct_structures_api_v1_constructs__construct_id__structures_get","parameters":[{"name":"construct_id","in":"path","required":true,"schema":{"type":"integer","title":"Construct Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConstructStructureList"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/binding-assays":{"get":{"tags":["binding-assays"],"summary":"Binding Assays","operationId":"binding_assays_api_v1_binding_assays_get","parameters":[{"name":"protein_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Id"}},{"name":"protein_variant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Protein Variant Id"}},{"name":"paper_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"}},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead.","title":"Protein"},"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead."},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring of the paper's DOI, as on `/papers`.","title":"Doi"},"description":"Case-insensitive substring of the paper's DOI, as on `/papers`."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BindingAssayList"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/binding-assays/{assay_id}":{"get":{"tags":["binding-assays"],"summary":"Binding Assay","operationId":"binding_assay_api_v1_binding_assays__assay_id__get","parameters":[{"name":"assay_id","in":"path","required":true,"schema":{"type":"integer","title":"Assay Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BindingAssayRead"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/interactions":{"get":{"tags":["evidence"],"summary":"List Interactions","description":"Interactions (an actor tested against a plastic in one paper), by id.","operationId":"list_interactions_api_v1_interactions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Evidence credited to this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Credited means its own whole-organism assays (not as an expression host, knockout or engineered host) or its enzymes' assays — the `organism_or_enzyme` scope.","title":"Microorganism"},"description":"Evidence credited to this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Credited means its own whole-organism assays (not as an expression host, knockout or engineered host) or its enzymes' assays — the `organism_or_enzyme` scope."},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead.","title":"Protein"},"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead."},{"name":"evidence_level","in":"query","required":false,"schema":{"enum":["all","direct","indirect"],"type":"string","description":"With `protein` or `microorganism`: `direct` is evidence recorded on that record itself (the protein's or variant's own assays; the organism's whole-organism assays), `indirect` is evidence credited to it through another record (a protein's engineered variants; an organism's enzymes), `all` both. `direct`/`indirect` without `protein` or `microorganism` is a 422.","default":"all","title":"Evidence Level"},"description":"With `protein` or `microorganism`: `direct` is evidence recorded on that record itself (the protein's or variant's own assays; the organism's whole-organism assays), `indirect` is evidence credited to it through another record (a protein's engineered variants; an organism's enzymes), `all` both. `direct`/`indirect` without `protein` or `microorganism` is a 422."},{"name":"paper_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"}},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring of the paper's DOI, as on `/papers`.","title":"Doi"},"description":"Case-insensitive substring of the paper's DOI, as on `/papers`."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Interaction outcome: positive, negative or inconclusive. No default: without it, every outcome matches.","title":"Polarity"},"description":"Interaction outcome: positive, negative or inconclusive. No default: without it, every outcome matches."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"An experiment used this method (closed vocabulary).","title":"Evidence Method"},"description":"An experiment used this method (closed vocabulary)."},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"An experiment tested this substrate form.","title":"Substrate Form"},"description":"An experiment tested this substrate form."},{"name":"measurement_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"An observation quantified this, by its exact name (e.g. `weight_loss`, `co2_evolved`).","title":"Measurement Type"},"description":"An observation quantified this, by its exact name (e.g. `weight_loss`, `co2_evolved`)."},{"name":"has_quantitative","in":"query","required":false,"schema":{"type":"boolean","description":"true: an observation carries a numeric value.","default":false,"title":"Has Quantitative"},"description":"true: an observation carries a numeric value."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceList_InteractionRecord_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/interactions/{interaction_id}":{"get":{"tags":["evidence"],"summary":"Get Interaction","operationId":"get_interaction_api_v1_interactions__interaction_id__get","parameters":[{"name":"interaction_id","in":"path","required":true,"schema":{"type":"integer","title":"Interaction Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InteractionRecord"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"404":{"description":"No such public record, or an unknown release."},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/experiments":{"get":{"tags":["evidence"],"summary":"List Experiments","description":"Experiments (one technique applied to an interaction, with its conditions),\nby id. The interaction filters apply to each experiment's interaction; the\nobservation filters ask one of its observations to match them all.","operationId":"list_experiments_api_v1_experiments_get","parameters":[{"name":"interaction_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Interaction Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Evidence credited to this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Credited means its own whole-organism assays (not as an expression host, knockout or engineered host) or its enzymes' assays — the `organism_or_enzyme` scope.","title":"Microorganism"},"description":"Evidence credited to this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Credited means its own whole-organism assays (not as an expression host, knockout or engineered host) or its enzymes' assays — the `organism_or_enzyme` scope."},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead.","title":"Protein"},"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead."},{"name":"evidence_level","in":"query","required":false,"schema":{"enum":["all","direct","indirect"],"type":"string","description":"With `protein` or `microorganism`: `direct` is evidence recorded on that record itself (the protein's or variant's own assays; the organism's whole-organism assays), `indirect` is evidence credited to it through another record (a protein's engineered variants; an organism's enzymes), `all` both. `direct`/`indirect` without `protein` or `microorganism` is a 422.","default":"all","title":"Evidence Level"},"description":"With `protein` or `microorganism`: `direct` is evidence recorded on that record itself (the protein's or variant's own assays; the organism's whole-organism assays), `indirect` is evidence credited to it through another record (a protein's engineered variants; an organism's enzymes), `all` both. `direct`/`indirect` without `protein` or `microorganism` is a 422."},{"name":"paper_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"}},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring of the paper's DOI, as on `/papers`.","title":"Doi"},"description":"Case-insensitive substring of the paper's DOI, as on `/papers`."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Interaction outcome: positive, negative or inconclusive. No default: without it, every outcome matches.","title":"Polarity"},"description":"Interaction outcome: positive, negative or inconclusive. No default: without it, every outcome matches."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"An experiment used this method (closed vocabulary).","title":"Evidence Method"},"description":"An experiment used this method (closed vocabulary)."},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"An experiment tested this substrate form.","title":"Substrate Form"},"description":"An experiment tested this substrate form."},{"name":"measurement_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"An observation quantified this, by its exact name (e.g. `weight_loss`, `co2_evolved`).","title":"Measurement Type"},"description":"An observation quantified this, by its exact name (e.g. `weight_loss`, `co2_evolved`)."},{"name":"has_quantitative","in":"query","required":false,"schema":{"type":"boolean","description":"true: an observation carries a numeric value.","default":false,"title":"Has Quantitative"},"description":"true: an observation carries a numeric value."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceList_ExperimentRecord_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/experiments/{experiment_id}":{"get":{"tags":["evidence"],"summary":"Get Experiment","operationId":"get_experiment_api_v1_experiments__experiment_id__get","parameters":[{"name":"experiment_id","in":"path","required":true,"schema":{"type":"integer","title":"Experiment Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentRecord"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"404":{"description":"No such public record, or an unknown release."},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/observations":{"get":{"tags":["evidence"],"summary":"List Observations","description":"Observations (one result an experiment produced), by id. The interaction and\nexperiment filters apply to the observation's own experiment and interaction.","operationId":"list_observations_api_v1_observations_get","parameters":[{"name":"interaction_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Interaction Id"}},{"name":"experiment_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Experiment Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types.","title":"Plastic"},"description":"Records with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'. Add `include_subtypes=true` to include its curated sub-types."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"plastic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plastic Id"}},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Evidence credited to this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Credited means its own whole-organism assays (not as an expression host, knockout or engineered host) or its enzymes' assays — the `organism_or_enzyme` scope.","title":"Microorganism"},"description":"Evidence credited to this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Credited means its own whole-organism assays (not as an expression host, knockout or engineered host) or its enzymes' assays — the `organism_or_enzyme` scope."},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead.","title":"Protein"},"description":"A protein or engineered-variant accession (e.g. `PB00012`), any case. `protein_id` / `protein_variant_id` take the numeric ids instead."},{"name":"evidence_level","in":"query","required":false,"schema":{"enum":["all","direct","indirect"],"type":"string","description":"With `protein` or `microorganism`: `direct` is evidence recorded on that record itself (the protein's or variant's own assays; the organism's whole-organism assays), `indirect` is evidence credited to it through another record (a protein's engineered variants; an organism's enzymes), `all` both. `direct`/`indirect` without `protein` or `microorganism` is a 422.","default":"all","title":"Evidence Level"},"description":"With `protein` or `microorganism`: `direct` is evidence recorded on that record itself (the protein's or variant's own assays; the organism's whole-organism assays), `indirect` is evidence credited to it through another record (a protein's engineered variants; an organism's enzymes), `all` both. `direct`/`indirect` without `protein` or `microorganism` is a 422."},{"name":"paper_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paper Id"}},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring of the paper's DOI, as on `/papers`.","title":"Doi"},"description":"Case-insensitive substring of the paper's DOI, as on `/papers`."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Interaction outcome: positive, negative or inconclusive. No default: without it, every outcome matches.","title":"Polarity"},"description":"Interaction outcome: positive, negative or inconclusive. No default: without it, every outcome matches."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"An experiment used this method (closed vocabulary).","title":"Evidence Method"},"description":"An experiment used this method (closed vocabulary)."},{"name":"substrate_form","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SubstrateForm"},{"type":"null"}],"description":"An experiment tested this substrate form.","title":"Substrate Form"},"description":"An experiment tested this substrate form."},{"name":"measurement_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"An observation quantified this, by its exact name (e.g. `weight_loss`, `co2_evolved`).","title":"Measurement Type"},"description":"An observation quantified this, by its exact name (e.g. `weight_loss`, `co2_evolved`)."},{"name":"has_quantitative","in":"query","required":false,"schema":{"type":"boolean","description":"true: an observation carries a numeric value.","default":false,"title":"Has Quantitative"},"description":"true: an observation carries a numeric value."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceList_ObservationRecord_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/observations/{observation_id}":{"get":{"tags":["evidence"],"summary":"Get Observation","operationId":"get_observation_api_v1_observations__observation_id__get","parameters":[{"name":"observation_id","in":"path","required":true,"schema":{"type":"integer","title":"Observation Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservationRecord"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"404":{"description":"No such public record, or an unknown release."},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/jobs/shared/{token}":{"get":{"tags":["jobs"],"summary":"A shared job, read-only, by its share token","description":"The job a share link points at — the same payload as ``GET /jobs/{id}``, authorised by the\ntoken in the path. 404 for an unknown or revoked link, 410 for an expired one.","operationId":"get_shared_job_api_v1_jobs_shared__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"include","in":"query","required":false,"schema":{"enum":["results","none"],"type":"string","description":"`results` (default): every hit in `results`. `none`: no hits (`results` is empty, `result_count` still counts them) — for polling; page the hits with `GET /jobs/{id}/results`.","default":"results","title":"Include"},"description":"`results` (default): every hit in `results`. `none`: no hits (`results` is empty, `result_count` still counts them) — for polling; page the hits with `GET /jobs/{id}/results`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"The share link is unknown or revoked.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"410":{"description":"The share link has expired.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/shared/{token}/results":{"get":{"tags":["jobs"],"summary":"A shared job's hits, one page at a time","description":"``GET /jobs/{id}/results`` for a share link.","operationId":"list_shared_job_results_api_v1_jobs_shared__token__results_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Hits per page.","default":100,"title":"Limit"},"description":"Hits per page."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_JobResultItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"404":{"description":"The share link is unknown or revoked.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"410":{"description":"The share link has expired.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/shared/{token}/download":{"get":{"tags":["jobs"],"summary":"Download a shared job's results","description":"``GET /jobs/{id}/download`` for a share link. Same files, same view parameters; no\nAuthorization header needed.","operationId":"download_shared_job_api_v1_jobs_shared__token__download_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"scov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off.","title":"Scov"},"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off."},{"name":"qcov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off.","title":"Qcov"},"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"bitscore","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off.","title":"Bitscore"},"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"true: apply no filter at all (every stored hit).","default":false,"title":"All"},"description":"true: apply no filter at all (every stored hit)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"The share link is unknown or revoked.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"410":{"description":"The job's result files were deleted by the retention policy: `reason: expired` and `results_expired_at`.","content":{"application/json":{"schema":{"type":"object","title":"JobResultsExpired","required":["detail"],"properties":{"detail":{"type":"string"},"reason":{"type":"string","enum":["expired"]},"results_expired_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/shared/{token}/comparison":{"get":{"tags":["jobs"],"summary":"A shared job's comparison matrix","description":"``GET /jobs/{id}/comparison`` for a share link.","operationId":"shared_job_comparison_api_v1_jobs_shared__token__comparison_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","csv","json"],"type":"string","default":"tsv","title":"Format"}},{"name":"scov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off.","title":"Scov"},"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off."},{"name":"qcov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off.","title":"Qcov"},"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"bitscore","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off.","title":"Bitscore"},"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"true: apply no filter at all (every stored hit).","default":false,"title":"All"},"description":"true: apply no filter at all (every stored hit)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}":{"get":{"tags":["jobs"],"summary":"Get Job","description":"A job, with its hits unless ``include=none`` (then page them through\n``GET /jobs/{id}/results``). Carries the job's own release in ``X-PlasticDB-Release``.","operationId":"get_job_api_v1_jobs__job_id__get","security":[{},{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]},{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"include","in":"query","required":false,"schema":{"enum":["results","none"],"type":"string","description":"`results` (default): every hit in `results`. `none`: no hits (`results` is empty, `result_count` still counts them) — for polling; page the hits with `GET /jobs/{id}/results`.","default":"results","title":"Include"},"description":"`results` (default): every hit in `results`. `none`: no hits (`results` is empty, `result_count` still counts them) — for polling; page the hits with `GET /jobs/{id}/results`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"403":{"description":"The job is private to its owner (`Access denied`).","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"404":{"description":"No such job.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}/results":{"get":{"tags":["jobs"],"summary":"A job's hits, one page at a time","description":"The hits of ``GET /jobs/{id}``, in the same order, as ``{total, items}``.","operationId":"list_job_results_api_v1_jobs__job_id__results_get","security":[{},{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]},{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Hits per page.","default":100,"title":"Limit"},"description":"Hits per page."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_JobResultItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"403":{"description":"The job is private to its owner (`Access denied`).","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"404":{"description":"No such job.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}/comparison":{"get":{"tags":["jobs"],"summary":"Download Job Comparison","description":"The Compare Genomes matrix for a view of the hits: one row per genome, one column per\nplastic (raw counts, then normalised).","operationId":"download_job_comparison_api_v1_jobs__job_id__comparison_get","security":[{},{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]},{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","csv","json"],"type":"string","description":"`tsv` (default), `csv`, or `json` (`{comparison, view}`, what the job page draws).","default":"tsv","title":"Format"},"description":"`tsv` (default), `csv`, or `json` (`{comparison, view}`, what the job page draws)."},{"name":"scov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off.","title":"Scov"},"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off."},{"name":"qcov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off.","title":"Qcov"},"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"bitscore","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off.","title":"Bitscore"},"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"true: apply no filter at all (every stored hit).","default":false,"title":"All"},"description":"true: apply no filter at all (every stored hit)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}/download":{"get":{"tags":["jobs"],"summary":"Download Job Results","description":"Stream a job's results file.","operationId":"download_job_results_api_v1_jobs__job_id__download_get","security":[{},{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]},{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"scov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off.","title":"Scov"},"description":"Hide hits covering less than this % of the reference sequence. Omitted: the job's default view (70 unless the job set another); 0: off."},{"name":"qcov","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off.","title":"Qcov"},"description":"Hide hits covering less than this % of the query sequence. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"bitscore","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off.","title":"Bitscore"},"description":"Hide hits below this bitscore. Omitted: the job's default (off unless the job set one); 0: off."},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"true: apply no filter at all (every stored hit).","default":false,"title":"All"},"description":"true: apply no filter at all (every stored hit)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"403":{"description":"The job is private to its owner (`Access denied`).","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"404":{"description":"No such job.","content":{"application/json":{"schema":{"type":"object","title":"JobError","required":["detail"],"properties":{"detail":{"type":"string"}}}}}},"410":{"description":"The job's result files were deleted by the retention policy: `reason: expired` and `results_expired_at`.","content":{"application/json":{"schema":{"type":"object","title":"JobResultsExpired","required":["detail"],"properties":{"detail":{"type":"string"},"reason":{"type":"string","enum":["expired"]},"results_expired_at":{"type":"string","format":"date-time"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/papers":{"get":{"tags":["papers"],"summary":"List Papers","description":"List papers, optionally filtered by bibliographic fields and by evidence.","operationId":"list_papers_api_v1_papers_get","parameters":[{"name":"sort_by","in":"query","required":false,"schema":{"enum":["year","citation","doi","title","journal","id"],"type":"string","description":"Sort key. Ties always break by `id`, so offset paging is stable.","default":"year","title":"Sort By"},"description":"Sort key. Ties always break by `id`, so offset paging is stable."},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Sort Order"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'.","title":"Plastic"},"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope).","title":"Microorganism"},"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope)."},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this protein (or variant) accession.","title":"Protein"},"description":"Papers with evidence on this protein (or variant) accession."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Papers with at least one experiment using this method.","title":"Evidence Method"},"description":"Papers with at least one experiment using this method."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches.","title":"Polarity"},"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches."},{"name":"result","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","title":"Result"},"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","deprecated":true},{"name":"has_quantitative","in":"query","required":false,"schema":{"type":"boolean","description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss).","default":false,"title":"Has Quantitative"},"description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss)."},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"}},{"name":"journal","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal"}},{"name":"authors","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authors"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Corresponding-author country","title":"Country"},"description":"Corresponding-author country"},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those.","title":"Updated Since"},"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_PaperListItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/papers/export":{"get":{"tags":["papers"],"summary":"Export Papers","description":"Every paper matching the `/papers` filters, as BibTeX or RIS (E10).","operationId":"export_papers_api_v1_papers_export_get","parameters":[{"name":"format","in":"query","required":true,"schema":{"enum":["bibtex","ris"],"type":"string","description":"`bibtex` (a `.bib` file) or `ris` (a `.ris` file), for import into Zotero, EndNote, Mendeley, Covidence or Rayyan. UTF-8.","title":"Format"},"description":"`bibtex` (a `.bib` file) or `ris` (a `.ris` file), for import into Zotero, EndNote, Mendeley, Covidence or Rayyan. UTF-8."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."},{"name":"plastic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'.","title":"Plastic"},"description":"Papers with evidence on this plastic. Exact, case-insensitive match on the plastic's name, abbreviation or full name ('PE' or 'Polyethylene') — never a substring, so 'PE' does not match 'PET'."},{"name":"include_subtypes","in":"query","required":false,"schema":{"type":"boolean","description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE).","default":false,"title":"Include Subtypes"},"description":"With `plastic`, also match its curated sub-types (children in the plastic hierarchy, e.g. OXO-PE under PE)."},{"name":"microorganism","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope).","title":"Microorganism"},"description":"Papers with evidence on this organism: an NCBI tax-id (digits), a PlasticDB accession, or a name/synonym (substring). Includes enzymes purified from the organism (the site-wide 'organism or its enzyme' scope)."},{"name":"protein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Papers with evidence on this protein (or variant) accession.","title":"Protein"},"description":"Papers with evidence on this protein (or variant) accession."},{"name":"evidence_method","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvidenceMethod"},{"type":"null"}],"description":"Papers with at least one experiment using this method.","title":"Evidence Method"},"description":"Papers with at least one experiment using this method."},{"name":"polarity","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches.","title":"Polarity"},"description":"Papers reporting this outcome: positive, negative or inconclusive. No default here (unlike the entity lists): without it, every outcome matches."},{"name":"result","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ResultEnum"},{"type":"null"}],"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","title":"Result"},"description":"Deprecated alias of `polarity` (the name every other list uses). Sending both with different values is a 422.","deprecated":true},{"name":"has_quantitative","in":"query","required":false,"schema":{"type":"boolean","description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss).","default":false,"title":"Has Quantitative"},"description":"true: only papers with at least one observation carrying a numeric value (e.g. % weight loss)."},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Full-text search query","title":"Q"},"description":"Full-text search query"},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},{"name":"doi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doi"}},{"name":"journal","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Journal"}},{"name":"authors","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authors"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Corresponding-author country","title":"Country"},"description":"Corresponding-author country"},{"name":"min_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Minimum publication year (≥)","title":"Min Year"},"description":"Minimum publication year (≥)"},{"name":"max_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum publication year (≤)","title":"Max Year"},"description":"Maximum publication year (≤)"},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those.","title":"Updated Since"},"description":"Incremental sync: only records whose own row changed at or after this ISO 8601 timestamp (e.g. `2026-10-01T00:00:00Z`; a timestamp without an offset is read as UTC). Each record carries the `updated_at` it is compared against. Records removed or merged since then are not in a list — ask `/api/v1/changes?since=` for those."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/papers/{paper_id}/export":{"get":{"tags":["papers"],"summary":"Export Paper","description":"One paper as BibTeX or RIS.","operationId":"export_paper_api_v1_papers__paper_id__export_get","parameters":[{"name":"paper_id","in":"path","required":true,"schema":{"type":"integer","title":"Paper Id"}},{"name":"format","in":"query","required":true,"schema":{"enum":["bibtex","ris"],"type":"string","description":"`bibtex` (a `.bib` file) or `ris` (a `.ris` file), for import into Zotero, EndNote, Mendeley, Covidence or Rayyan. UTF-8.","title":"Format"},"description":"`bibtex` (a `.bib` file) or `ris` (a `.ris` file), for import into Zotero, EndNote, Mendeley, Covidence or Rayyan. UTF-8."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/papers/{paper_id}":{"get":{"tags":["papers"],"summary":"Get Paper","operationId":"get_paper_api_v1_papers__paper_id__get","parameters":[{"name":"paper_id","in":"path","required":true,"schema":{"type":"integer","title":"Paper Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaperDetail"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/papers/{paper_id}/footprint":{"get":{"tags":["papers"],"summary":"Get Paper Footprint Public","description":"Public read-only view of everything derived from a paper.","operationId":"get_paper_footprint_public_api_v1_papers__paper_id__footprint_get","security":[{},{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]},{"APIKeyHeader":[]}],"parameters":[{"name":"paper_id","in":"path","required":true,"schema":{"type":"integer","title":"Paper Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaperFootprint"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search":{"get":{"tags":["search"],"summary":"Global Search","description":"Search across all entities: microorganisms, proteins, plastics, references.","operationId":"global_search_api_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPage"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search/grouped":{"get":{"tags":["search"],"summary":"Grouped Search","description":"Search each entity category independently — top-``limit`` plus a true total.","operationId":"grouped_search_api_v1_search_grouped_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupedSearch"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search/autocomplete":{"get":{"tags":["search"],"summary":"Global Autocomplete","description":"Return top-5 matches per entity type for the search bar dropdown.","operationId":"global_autocomplete_api_v1_search_autocomplete_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":200,"title":"Q"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutocompleteResult"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats":{"get":{"tags":["stats"],"summary":"Public Stats","operationId":"public_stats_api_v1_stats_get","parameters":[{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/EvidenceScope","description":"Which organisms `microorganisms` counts, with `/microorganisms?evidence_scope=`'s meaning (an entity count).","default":"organism_or_enzyme"},"description":"Which organisms `microorganisms` counts, with `/microorganisms?evidence_scope=`'s meaning (an entity count)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicStats"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats/protein-activity":{"get":{"tags":["stats"],"summary":"Protein Activity Stats","description":"Disjoint evidence classes, using the public list's visibility and filters.","operationId":"protein_activity_stats_api_v1_stats_protein_activity_get","parameters":[{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProteinActivityStats"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats/charts":{"get":{"tags":["stats"],"summary":"Stats Charts","operationId":"stats_charts_api_v1_stats_charts_get","parameters":[{"name":"evidence_scope","in":"query","required":false,"schema":{"$ref":"#/components/schemas/RowEvidenceScope","default":"organism_or_enzyme"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsCharts"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats/by-country":{"get":{"tags":["stats"],"summary":"Stats By Country","operationId":"stats_by_country_api_v1_stats_by_country_get","parameters":[{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsByCountry"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tree/{job_id}":{"get":{"tags":["tree"],"summary":"Get a Taxonomy Tree job (Newick + plastic matrix)","description":"Poll a tree job for status and results. A tree job answers with the release it was\nbuilt against (its `release` field and the `X-PlasticDB-Release` header); pin it when\nsubmitting, with `POST /tree/build?release=`. A tree is private to its owner,\nas on `GET /jobs/{id}` (a tree built anonymously before 2.88.0 stays readable by id); share it with `POST /jobs/{id}/shares`.","operationId":"get_tree_job_api_v1_tree__job_id__get","security":[{},{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]},{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/snapshots":{"get":{"tags":["snapshots"],"summary":"List Snapshots","description":"List published snapshots, newest first, in the ``{total, items}`` envelope.","operationId":"list_snapshots_api_v1_snapshots_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_SnapshotListItem_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/snapshots/latest":{"get":{"tags":["snapshots"],"summary":"Latest Snapshot","description":"Return metadata for the most recently published snapshot.","operationId":"latest_snapshot_api_v1_snapshots_latest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotLatestResponse"}}}}}}},"/api/v1/snapshots/{snapshot_id}":{"get":{"tags":["snapshots"],"summary":"Get Snapshot","operationId":"get_snapshot_api_v1_snapshots__snapshot_id__get","parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"integer","title":"Snapshot Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/releases":{"get":{"tags":["releases"],"summary":"List Releases","description":"Every completed release, newest first — the dataset's version history.","operationId":"list_releases_api_v1_releases_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_DatasetReleaseRead_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/releases/current":{"get":{"tags":["releases"],"summary":"Current Release","description":"The release this site is currently serving, and how to cite it.","operationId":"current_release_api_v1_releases_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentReleaseResponse"}}}}}}},"/api/v1/releases/status":{"get":{"tags":["releases"],"summary":"Release Status","description":"Is a dataset release running right now? ``{running, version, started_at}``.","operationId":"release_status_api_v1_releases_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseRunStatus"}}}}}}},"/api/v1/releases/{version}":{"get":{"tags":["releases"],"summary":"Get Release","description":"One release by its version string (public fields only).","operationId":"get_release_api_v1_releases__version__get","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string","title":"Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetReleaseRead"}}}},"404":{"description":"Unknown release (`reason: unknown`).","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/releases/{version}/artefacts/{path}":{"get":{"tags":["releases"],"summary":"Download Release Artefact","description":"Download one file of a release's artefacts, or its ``MANIFEST.json``.","operationId":"download_release_artefact_api_v1_releases__version__artefacts__path__get","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string","title":"Version"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"The file.","content":{"application/json":{"schema":{}}},"headers":{"X-PlasticDB-SHA256":{"description":"The file's SHA-256, as listed in MANIFEST.json (absent for MANIFEST.json itself).","schema":{"type":"string"}},"ETag":{"description":"The same digest, quoted.","schema":{"type":"string"}}}},"404":{"description":"Unknown release (`reason: unknown`), or no such file in it (`detail` only).","content":{"application/json":{"schema":{"type":"object","title":"ReleaseFileError","required":["detail"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"Recorded, but not readable here (`reason: not_mounted`).","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/releases/{version}/structures/{structure_id}":{"get":{"tags":["releases"],"summary":"Get Release Structure","description":"The coordinate file of one structure row in a release (S5b).","operationId":"get_release_structure_api_v1_releases__version__structures__structure_id__get","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string","title":"Version"}},{"name":"structure_id","in":"path","required":true,"schema":{"type":"integer","title":"Structure Id"}}],"responses":{"307":{"description":"Redirect to the coordinate file.","content":{"application/json":{"schema":{}}}},"404":{"description":"Unknown release (`reason: unknown`), or no such file in it (`detail` only).","content":{"application/json":{"schema":{"type":"object","title":"ReleaseFileError","required":["detail"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pathways":{"get":{"tags":["pathways"],"summary":"List Pathways","description":"Every curated pathway, by plastic name, in the ``{total, items}`` envelope.","operationId":"list_pathways_api_v1_pathways_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422).","title":"Page"},"description":"1-based page number, an alternative to `offset`: `page=N` means `offset=(N-1)*limit`. Send one or the other; a non-zero `offset` together with `page` is rejected (422)."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_PathwayListItem_"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/pathways/{pathway_id}":{"get":{"tags":["pathways"],"summary":"Get Pathway","operationId":"get_pathway_api_v1_pathways__pathway_id__get","parameters":[{"name":"pathway_id","in":"path","required":true,"schema":{"type":"integer","title":"Pathway Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PathwayRead"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/pathways/by-plastic/{plastic_id}":{"get":{"tags":["pathways"],"summary":"Get Pathways By Plastic","description":"Get all pathways for a specific plastic (ordered by id).","operationId":"get_pathways_by_plastic_api_v1_pathways_by_plastic__plastic_id__get","parameters":[{"name":"plastic_id","in":"path","required":true,"schema":{"type":"integer","title":"Plastic Id"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PathwayRead"},"title":"Response Get Pathways By Plastic Api V1 Pathways By Plastic  Plastic Id  Get"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/pathways/by-plastic/{plastic_id}/graph":{"get":{"tags":["pathways"],"summary":"Get Pathway Graph","description":"Return pathway data as a Cytoscape.js-compatible graph (nodes + edges).","operationId":"get_pathway_graph_api_v1_pathways_by_plastic__plastic_id__graph_get","parameters":[{"name":"plastic_id","in":"path","required":true,"schema":{"type":"integer","title":"Plastic Id"}},{"name":"pathway_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Specific pathway ID to render; defaults to the first pathway for this plastic.","title":"Pathway Id"},"description":"Specific pathway ID to render; defaults to the first pathway for this plastic."},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered.","title":"Release"},"description":"Answer from a dataset release (e.g. `2026.35`; see `/api/v1/releases`). Omitted, or the current release: the live database. A past release is answered from that release's immutable Parquet artefacts, in the same response shape; a filter the snapshot cannot answer is a 422 naming it. Unknown release, or one without artefacts: 404. The `X-PlasticDB-Release` response header says which release answered."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PathwayGraphResponse"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}},"X-PlasticDB-Snapshot-Unavailable":{"description":"On a past-release answer: the fields the release cannot fill (served empty), comma-separated paths.","schema":{"type":"string"}}}},"422":{"description":"Validation error. On a past release, each filter or option it cannot answer is an item with `type: release_unsupported`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"404":{"description":"Unknown release, or one without artefacts.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"503":{"description":"The release's artefacts are not readable here.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}}}}},"/api/v1/vocabularies":{"get":{"tags":["vocabularies"],"summary":"Get Vocabularies","description":"Return all controlled vocabularies used by the extraction skill and validator.","operationId":"get_vocabularies_api_v1_vocabularies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Vocabularies Api V1 Vocabularies Get"}}}}}}},"/api/v1/vocabulary":{"get":{"tags":["vocabulary"],"summary":"Vocabulary Index","description":"Index of the controlled vocabularies, each with its version.","operationId":"vocabulary_index_api_v1_vocabulary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/vocabulary/{name}":{"get":{"tags":["vocabulary"],"summary":"Vocabulary Detail","description":"One controlled vocabulary: its values and where in the payload they apply.","operationId":"vocabulary_detail_api_v1_vocabulary__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/changes":{"get":{"tags":["sync"],"summary":"List Changes","description":"Records updated, removed or merged since a timestamp (incremental sync).","operationId":"list_changes_api_v1_changes_get","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","format":"date-time","description":"ISO 8601 timestamp (an offset-less one is read as UTC). Returns every record that changed at or after it. Store the response's `as_of` and pass it as the next `since`.","title":"Since"},"description":"ISO 8601 timestamp (an offset-less one is read as UTC). Returns every record that changed at or after it. Store the response's `as_of` and pass it as the next `since`."},{"name":"entity_type","in":"query","required":false,"schema":{"anyOf":[{"enum":["protein","protein_variant","microorganism","plastic","paper"],"type":"string"},{"type":"null"}],"description":"Restrict the feed to one entity type.","title":"Entity Type"},"description":"Restrict the feed to one entity type."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":500,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"release","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one.","title":"Release"},"description":"Only the current release can answer this endpoint (it is computed live). A past release is a 409 that names the current one."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangesFeed"}}},"headers":{"X-PlasticDB-Release":{"description":"The dataset release that answered (the current one for a live answer).","schema":{"type":"string"}},"X-PlasticDB-Release-Source":{"description":"`snapshot` (a past release's Parquet artefacts) or `live`.","schema":{"type":"string","enum":["snapshot","live"]}}}},"409":{"description":"Computed live: a past release cannot answer it.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"404":{"description":"Unknown release.","content":{"application/json":{"schema":{"type":"object","title":"ReleaseError","required":["detail","reason"],"properties":{"detail":{"type":"string"},"release":{"type":"string"},"current_release":{"type":"string","nullable":true},"reason":{"type":"string","enum":["unknown","no_artefacts","live_only","not_mounted"]}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"servers":[{"url":"https://v2.plasticdb.org"}]}