Skip to main content
All providers

RCSB Protein Data Bank

ResearchUS

data.rcsb.org

The US arm of the Worldwide Protein Data Bank: experimentally determined 3D structures of proteins, nucleic acids and their complexes, with their sequences, ligands, biological assemblies, interfaces, validation metrics and links out to UniProt, PubMed and DrugBank.

Capabilities (29)

GET /v1/data/rcsbpdb/assembly1 credit

Returns one biological assembly of an entry: how it was determined (author or software defined), its oligomeric state and stoichiometry, the symmetry and point group, buried surface area, and the transformations that generate it.

entry_idassembly_id
GET /v1/data/rcsbpdb/branched-entity-instance1 credit

Returns one modelled oligosaccharide chain: its chain identifiers, the covalent and non-covalent connections linking it to the protein, and its per-instance feature annotations.

entry_idasym_id
GET /v1/data/rcsbpdb/chemical-component1 credit

Returns the Chemical Component Dictionary definition of a ligand, ion or monomer: formula, formula weight, systematic and synonym names, SMILES and InChI descriptors, atom and bond lists, and cross-references to DrugBank, ChEMBL and PubChem.

comp_id
GET /v1/data/rcsbpdb/current-ccd-ids1 credit

Returns a JSON array of every chemical component (ligand) ID currently defined in the PDB Chemical Component Dictionary.

No parameters
GET /v1/data/rcsbpdb/current-entry-ids1 credit

Returns a JSON array of every PDB ID currently released in the archive, roughly 240,000 four-character codes.

No parameters
GET /v1/data/rcsbpdb/current-prd-ids1 credit

Returns a JSON array of every current PRD_ identifier in the Biologically Interesting molecule Reference Dictionary, the peptide-like antibiotics and inhibitors held as reference molecules.

No parameters
GET /v1/data/rcsbpdb/drugbank-annotations1 credit

Returns the DrugBank record RCSB has integrated for a chemical component: DrugBank ID, description, drug categories, ATC codes, indication, mechanism of action, affected organisms and known drug targets.

comp_id
GET /v1/data/rcsbpdb/entry1 credit

Returns the full metadata record for one PDB entry: title, experimental method and resolution, cell and symmetry, deposition and release dates, authors, primary citation, assembly and entity identifiers, and the aggregate rcsb_entry_info counts.

entry_id
GET /v1/data/rcsbpdb/entry-group1 credit

Returns a group of related PDB entries: the list of member entry IDs, the provenance that created the group, and the group's name and description.

group_id
GET /v1/data/rcsbpdb/entry-status1 credit

Returns the repository status of one PDB ID: whether it is current, removed or unreleased, its status code, and the IDs that superseded it where it was replaced.

entry_id
GET /v1/data/rcsbpdb/entry-status-batch1 credit

Returns the repository status records for a comma-separated list of PDB IDs in one response, each with its status, status code and replacement IDs.

ids
GET /v1/data/rcsbpdb/graphql1 credit

Runs a read-only GraphQL query against the whole RCSB data graph over GET, returning exactly the fields asked for and allowing many entries, entities, assemblies or chemical components to be fetched in a single response.

queryvariables?operationName?
GET /v1/data/rcsbpdb/group-provenance1 credit

Returns how a family of groups was built: the aggregation type, the similarity method and, for sequence groups, the identity cutoffs used.

group_provenance_id
GET /v1/data/rcsbpdb/interface1 credit

Returns one pairwise polymeric interface in a biological assembly: the two partner chains, buried surface area, the interface character and the per-residue contacts that form it.

entry_idassembly_idinterface_id
GET /v1/data/rcsbpdb/nonpolymer-entity1 credit

Returns one non-polymer (ligand, ion or cofactor) entity of an entry: its chemical component ID, name, formula weight, copy count and the chain identifiers it occupies.

entry_identity_id
GET /v1/data/rcsbpdb/nonpolymer-entity-instance1 credit

Returns one modelled copy of a ligand or ion: its chain and residue numbering, the component ID, and the validation scores and fit-to-density metrics for that individual copy.

entry_idasym_id
GET /v1/data/rcsbpdb/polymer-entity1 credit

Returns one polymer entity (a distinct protein, DNA or RNA molecule in an entry): its one-letter sequence, source and host organism, EC numbers, UniProt and other database cross-references, sequence annotations and features, target cofactors, and its sequence-identity group memberships.

entry_identity_id
GET /v1/data/rcsbpdb/polymer-entity-group1 credit

Returns a group of polymer entities that share a sequence: the member entity IDs (entry_entity form), the aggregation method and identity cutoff used, and the group's summary attributes.

group_id
GET /v1/data/rcsbpdb/polymer-entity-instance1 credit

Returns one modelled polymer chain: its author and label chain IDs, secondary-structure and binding-site features, observed versus unobserved residue ranges, modified residues, and per-instance validation outliers.

entry_idasym_id
GET /v1/data/rcsbpdb/pubmed-annotations1 credit

Returns the PubMed record for an entry's primary citation: PubMed ID, DOI, title, abstract text, journal, authors, MeSH terms and the article's PubMed Central identifiers where present.

entry_id
GET /v1/data/rcsbpdb/removed-entry1 credit

Returns the archival record of an entry that was withdrawn from the PDB: its original title and authors, deposition and release dates, the reason it was removed, and the IDs that replaced it.

entry_id
GET /v1/data/rcsbpdb/removed-entry-ids1 credit

Returns a JSON array of every PDB ID that has been withdrawn from the archive.

No parameters
GET /v1/data/rcsbpdb/schema1 credit

Returns the JSON Schema for one RCSB data collection, listing every field the corresponding core endpoint can return with its type, enumerations, examples and description.

collection
GET /v1/data/rcsbpdb/search1 credit

Runs an RCSB Search API query and returns the matching identifiers with relevance scores and a total count; supports full-text, attribute, sequence, chemical and structural services, boolean groups, sorting and paging.

json
GET /v1/data/rcsbpdb/search-attribute-schema1 credit

Returns the JSON Schema of every attribute that can be used in a Search API attribute query, with each attribute's type, allowed operators, enumerations and description. One combined document of about 1.4 MB covering all collections; it takes no parameters.

No parameters
GET /v1/data/rcsbpdb/uniprot-annotations1 credit

Returns the UniProt records matched to one polymer entity: accession, protein and gene names, source organism, the full UniProt sequence, keywords, GO and other database cross-references, and sequence features such as domains and variants.

entry_identity_id
GET /v1/data/rcsbpdb/unreleased-entries-batch1 credit

Returns the deposition records of several unreleased entries in one response, each with deposit date, title, authors and hold status.

ids
GET /v1/data/rcsbpdb/unreleased-entry1 credit

Returns what is public about a deposited but not yet released structure: deposit date, title, authors, prerelease sequence status and the hold status governing its release.

entry_id
GET /v1/data/rcsbpdb/unreleased-entry-ids1 credit

Returns a JSON array of every PDB ID that is deposited and on hold but not yet released.

No parameters

Licence

CC0 1.0 Universal Public Domain Dedication. The RCSB PDB Usage Policies page states: "The wwPDB policy states that data files contained in the PDB archive are available under the CC0 1.0 Universal (CC0 1.0) Public Domain Dedication. All data provided by RCSB PDB programmatic APIs are available under the same license. All data are presented at RCSB.org without any warranties about the work; RCSB PDB disclaims liability for all uses of the work, to the fullest extent permitted by applicable law. Users of PDB data are encouraged to attribute the original authors of the PDB structure data where possible." Commercial use and redistribution are therefore both permitted. Attribution is encouraged, not required, and we credit RCSB PDB anyway. Note the separate terms RCSB applies to things we do not serve: Molecule of the Month illustrations are CC BY 4.0, and the articles and other site text are copyrighted.

https://www.rcsb.org/pages/usage-policy

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: RCSB Protein Data Bank (RCSB.org), data released under CC0 1.0. Structure data deposited by the original authors; please also cite the PDB entry and its primary citation.

Cache: up to 3600s