Protein Structure Data
Data Type: protein_structure
Primary Key: pdb_id
Attributes
-
alignments
(array of strings)
- Filenames or UUIDs of structure–sequence alignment files (e.g. generated by FATCAT or DALI) used to superimpose the PDB entry on related proteins. [ "1A2B_vs_Pfam00400.align", "1A2B_chainA.dali" ]
-
authors
(array of strings)
- Author list extracted from the original PDB deposition or associated journal article; displayed in structure-report headers. [ "Smith A J", "Lee B", "Patel C" ]
-
date_inserted
(date)
- ISO-8601 UTC datetime when the structure row was added to BV-BRC. Enables incremental database sync. "2023-05-23T13:17:41Z"
-
date_modified
(date)
- Updated whenever any field is edited (e.g. sequence mapping corrected). "2025-04-28T08:56:02Z"
-
feature_id
(string)
- `fig …` identifier of the CDS whose product maps to this PDB entry (best chain/segment).
-
file_path
(string)
- Internal path or URL to the gzipped .pdb, .cif, or mmCIF file stored by BV-BRC. "/pdb/2024/04/1A2B.cif.gz"
-
gene
(array of strings)
- Gene names for each chain mapped in the structure. [ "recA" ]
-
genome_id
(string)
- BV-BRC genome_id of the organism whose protein was crystallised; foreign-key for genome queries. "511145.183"
-
institution
(string)
- Lab or centre that solved the structure (from PDB HEADER). "Brookhaven National Laboratory"
-
method
(array of strings)
- Techniques reported in the PDB header: X-ray Diffraction, Cryo-EM, NMR. Stored as array because hybrid methods exist. [ "X-ray Diffraction" ]
-
organism_name
(array of case insensitive strings)
- Scientific names of biological sources for each chain; array supports chimeric constructs. [ "Escherichia coli K-12 MG1655" ]
-
patric_id
(string)
- Historical duplicate kept for compatibility with older APIs. `"fig
-
pdb_id
*
(string)
- Four-character PDB identifier uniquely defining the entry. "1A2B"
-
pmid
(array of strings)
- Literature citations linked to the structure. [ "98765432", "34567890" ]
-
product
(array of strings)
- Functional descriptions for each chain, mirroring gene array order. [ "DNA recombinase RecA" ]
-
release_date
(date)
- When the structure became publicly available in the PDB archive. "1999-07-22T00:00:00Z"
-
resolution
(string)
- Resolution string as reported ("2.1 Å" for X-ray; "3.0 Å map" for EM). "2.10 Å"
-
sequence
(array of strings)
- Amino-acid sequences for each chain in the entry, in order. [ "MQQLNVFT…KQL" ]
-
sequence_md5
(array of strings)
- 32-char MD5 digests parallel to sequence array; enables rapid mapping to identical chains in other genomes. [ "d41d8cd98f00b204e9800998ecf8427e" ]
-
taxon_id
(array of integers)
- NCBI taxonomy IDs matching organism_name entries. [ 562 ]
-
taxon_lineage_ids
(array of strings)
- Semicolon-delimited ancestry IDs for each organism; used in taxon-tree visualisations. [ "2;1224;1236;91347;543;562" ]
-
taxon_lineage_names
(array of strings)
- Parallel string of lineage names to complement taxon_lineage_ids. [ "Bacteria;Proteobacteria;Gammaproteobacteria;Enterobacterales;Enterobacteriaceae;Escherichia coli" ]
-
title
(case insensitive string)
- Free-text title line from the PDB header, displayed in search results. "Crystal structure of E. coli RecA bound to ssDNA"
-
uniprotkb_accession
(array of strings)
- UniProt accessions for each chain, aiding functional cross-links. [ "P0A7V8" ]
API
GET :pdb_id
Retrieve a protein_structure data object by pdb_id
EXAMPLE
https://www.bv-brc.org/api/protein_structure/103L
Try It!
QUERY :query
Query for protein_structure data objects with an RQL Query
Return Formats
Requests may include an HTTP ACCEPT header from this list to transform the data into the requested type.
-
application/json - Returns results as an array of JSON objects
-
application/solr+json - Results results in SOLR JSON response format
-
text/csv - Returns results in Comma Separated values (CSV) format. Columns are separated by ','. Multi-value columns are separated by ';'. Rows are separated by new line
-
text/tsv - Returns results in Tab Separated values (TSV) format. Columns are separated by a tab. Multi-value columns are separated by ';'. Rows are separated by new line
-
application/vnd.openxmlformats - Returns objects as an MS Excel document
EXAMPLE
- Query for protein_structure data objects with a pdb_id equal to 103L. Return results as a JSON Array.
https://www.bv-brc.org/api/protein_structure/?eq(pdb_id,103L)
Try It!