Skip to main content
GET
This endpoint keeps parity with the legacy esmatlas.com API, https://api.esmatlas.com/fetchPredictedStructure/{id}, for existing users of that API. It serves the same ESMFold structures from the original ESM Metagenomic Atlas, which covers only the older MGnify protein database version that Atlas was built from. Proteins are identified by their MGnify accession, such as MGYP000166900001, not by the protein_hash that the other Atlas endpoints use.
This endpoint does not cover proteins added to MGnify after that version, and it does not return data from the current ESM Atlas. For current Atlas proteins, structures, and features, use Get Protein.
Unlike the other Atlas endpoints, this endpoint requires a Biohub API key. Create an API key and send it as a Bearer token in the Authorization header.

Choose a format

Add a lowercase suffix to the structure ID to choose the file format. Any other suffix, including .PDB, returns 400. The PDB file stores pLDDT on a 0 to 1 scale in the B-factor column. The CIF file reports pLDDT on a 0 to 100 scale. The response body is the raw file, not JSON, so save it to disk as the examples do.

CIF output

The .cif response reproduces the esmatlas.com conversion, including its known issues:
  • It has no data_ block header.
  • It averages each residue’s pLDDT without that residue’s first atom, except for the first residue.
  • It shifts each residue’s pLDDT to the following residue and drops the last residue’s pLDDT.
  • It prints pLDDT values with floating-point noise, such as 57.99999999999999.
  • It hardcodes chain, entity, and model identifiers.
If you need standards-compliant mmCIF, download the PDB file and convert it with a validating tool such as Gemmi.

Authorizations

Authorization
string
header
required

Path Parameters

structure_id
string
required

MGnify protein accession, MGYP followed by exactly 12 digits. Add lowercase .pdb or no suffix for PDB, or .cif for CIF.

Pattern: ^MGYP[0-9]{12}(\.pdb|\.cif)?$

Response

The predicted structure file. Content-Disposition names the file {id}.pdb or {id}.cif.

PDB file with pLDDT on a 0 to 1 scale in the B-factor column.