{"openapi":"3.1.0","info":{"title":"PDB API","version":"1.0.0","description":"The RCSB Protein Data Bank as an API — 3D macromolecular structures of proteins, nucleic acids and complexes, powered by the official RCSB PDB data and search services. Fetch a structure entry by its 4-character PDB id for its title, experimental method (X-ray, cryo-EM, NMR), resolution, keywords, deposit and release dates, authors, primary citation and entity & assembly counts; run full-text search across the whole archive returning matching PDB ids and the total hit count; read a polymer entity for its protein or nucleic-acid name, one-letter sequence, length, source organism, chains and linked UniProt ids; read a biological assembly for its oligomeric state, symmetry and chain & atom counts; list the ligands bound in a structure with their component ids and names; and look up any chemical component (ligand) by code for its formula, weight, SMILES and InChIKey. Ideal for structural-biology and drug-discovery tools, molecular viewers, bioinformatics pipelines, education apps and research dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/pdb-api","description":"oanor gateway"}],"tags":[{"name":"Structures"},{"name":"Entities"},{"name":"Ligands"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Structures"],"summary":"Full-text search of the PDB","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Search text, e.g. hemoglobin","schema":{"type":"string"},"example":"hemoglobin"},{"name":"limit","in":"query","required":false,"description":"Max ids (1-100)","schema":{"type":"string"}},{"name":"start","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ids":["3GOU","6IHX","2PGH","9JYU","9RXG","3PEL","3PI9","3PIA","1FSX","6II1","1G0B","4YU3","1FHJ","1G08","1G09","1G0A","1HBR","2D5X","2QSP","5C6E","3CIU","2ZFB","2QLS","3GQP","3PI8"],"count":25,"query":"hemoglobin","start":0,"total":9054},"meta":{"timestamp":"2026-06-01T08:14:09.263Z","request_id":"95aa872c-33fa-46ca-844f-88173c98f61a"},"status":"ok","message":"Search results retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/structure":{"get":{"operationId":"get_v1_structure","tags":["Structures"],"summary":"A structure entry","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"4-char PDB id, e.g. 4HHB","schema":{"type":"string"},"example":"4HHB"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"structure":{"id":"4HHB","title":"THE CRYSTAL STRUCTURE OF HUMAN DEOXYHAEMOGLOBIN AT 1.74 ANGSTROMS RESOLUTION","method":["X-RAY DIFFRACTION"],"authors":["Fermi, G.","Perutz, M.F."],"citation":{"year":1984,"title":"The crystal structure of human deoxyhaemoglobin at 1.74 A resolution","journal":"J.Mol.Biol."},"keywords":"OXYGEN TRANSPORT","released":"1984-07-17","revision":"2024-05-22","deposited":"1984-03-07","resolution":1.74,"assembly_ids":["1"],"assembly_count":1,"molecular_weight":64.74,"polymer_entity_ids":["1","2"],"deposited_atom_count":4779,"polymer_entity_count":2,"nonpolymer_entity_count":2}},"meta":{"timestamp":"2026-06-01T08:14:10.023Z","request_id":"54e29fa5-5044-4ed9-bd10-9270efb01b8d"},"status":"ok","message":"Structure retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/assembly":{"get":{"operationId":"get_v1_assembly","tags":["Entities"],"summary":"A biological assembly","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"PDB id","schema":{"type":"string"},"example":"4HHB"},{"name":"assembly","in":"query","required":false,"description":"Assembly number (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"assembly":{"method":"PISA","pdb_id":"4HHB","details":"author_and_software_defined_assembly","symmetry":[{"type":"Cyclic","symbol":"C2","oligomeric_state":"Hetero 4-mer"},{"type":"Dihedral","symbol":"D2","oligomeric_state":"Homo 4-mer"}],"assembly_id":"1","total_atoms":4779,"modeled_residues":574,"oligomeric_count":4,"oligomeric_state":"tetrameric","polymer_entity_instances":4,"nonpolymer_entity_instances":6}},"meta":{"timestamp":"2026-06-01T08:14:10.191Z","request_id":"4a0ed668-ea3a-463a-aad6-3bec5b6019eb"},"status":"ok","message":"Assembly retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/polymer":{"get":{"operationId":"get_v1_polymer","tags":["Entities"],"summary":"A polymer entity (protein / nucleic acid)","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"PDB id","schema":{"type":"string"},"example":"4HHB"},{"name":"entity","in":"query","required":false,"description":"Entity number (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"polymer":{"name":"Hemoglobin subunit alpha","type":"Protein","chains":["A","C"],"length":141,"pdb_id":"4HHB","source":[{"organism":"Homo sapiens","taxonomy_id":9606}],"sequence":"VLSPADKTNVKAAWGKVGAHAGEYGAEALERMFLSFPTTKTYFPHFDLSHGSAQVKGHGKKVADALTNAVAHVDDMPNALSALSDLHAHKLRVDPVNFKLLSHCLLVTLAAHLPAEFTPAVHASLDKFLASVSTVLTSKYR","entity_id":"1","uniprot_ids":["P69905"]}},"meta":{"timestamp":"2026-06-01T08:14:10.346Z","request_id":"2f8ab080-efc2-450e-9870-b909d766efe9"},"status":"ok","message":"Polymer entity retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/chemcomp":{"get":{"operationId":"get_v1_chemcomp","tags":["Ligands"],"summary":"A chemical component / ligand","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Component id, e.g. HEM","schema":{"type":"string"},"example":"HEM"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chemcomp":{"id":"HEM","name":"PROTOPORPHYRIN IX CONTAINING FE","type":"non-polymer","formula":"C34 H32 Fe N4 O4","atom_count":75,"bond_count":82,"formula_weight":616.487}},"meta":{"timestamp":"2026-06-01T08:14:10.531Z","request_id":"9eb2ae14-1a8a-4899-8009-8b638563f7f7"},"status":"ok","message":"Chemical component retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ligands":{"get":{"operationId":"get_v1_ligands","tags":["Ligands"],"summary":"Ligands bound in a structure","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"PDB id","schema":{"type":"string"},"example":"4HHB"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"pdb_id":"4HHB","ligands":[{"name":"PROTOPORPHYRIN IX CONTAINING FE","chains":["A","B","C","D"],"comp_id":"HEM","entity_id":"3"},{"name":"PHOSPHATE ION","chains":["B","D"],"comp_id":"PO4","entity_id":"4"}]},"meta":{"timestamp":"2026-06-01T08:14:10.915Z","request_id":"508dd85d-8cf0-46ff-af88-b3edb7ae44f2"},"status":"ok","message":"Ligands retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"3D macromolecular structures from the RCSB PDB. /v1/structure?id=4HHB = a structure entry (title, experimental method, resolution, keywords, deposit/release dates, authors, primary citation, entity & assembly counts, molecular weight); /v1/search?query=hemoglobin = full-text search returning matching PDB ids and the total count (paginate with start & limit); /v1/polymer?id=4HHB&entity=1 = a polymer entity (protein/nucleic-acid name, type, one-letter sequence, length, source organism, chains, linked UniProt ids); /v1/assembly?id=4HHB&assembly=1 = a biological assembly (oligomeric state, symmetry, chain & atom counts); /v1/ligands?id=4HHB = the ligands bound in a structure (component id, name, chains); /v1/chemcomp?id=HEM = a chemical component / ligand definition (name, formula, weight, SMILES, InChIKey). PDB ids are 4 characters (e.g. 4HHB). Data courtesy of RCSB PDB. For protein sequences & function see the UniProt API.","source":"RCSB Protein Data Bank REST + search APIs (rcsb.org)","endpoints":["/v1/structure","/v1/search","/v1/polymer","/v1/assembly","/v1/ligands","/v1/chemcomp","/v1/meta"]},"meta":{"timestamp":"2026-06-01T08:14:11.000Z","request_id":"69861c60-3d6a-4a14-a47d-366668b24d74"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":550,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":710,"monthly_call_quota":19000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2050,"monthly_call_quota":88000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5700,"monthly_call_quota":340000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/pdb-api"}