PDBe Get Residue Listing

Overview

Get per-residue information for a PDB structure, optionally filtered by chain. Returns residue numbers (both PDB sequential and author-assigned), residue names (3-letter amino acid codes), and observed ratio (fraction of models where this residue has electron density). Useful for analyzing protein chain composition, identifying disordered/missing regions (observed_ratio < 1.0), or mapping between PDB and author numbering schemes. Example: '4hhb' chain A returns 141 residues (alpha globin) all with 1.0 observed ratio; '3ert' chain A returns 261 residues (estrogen receptor) starting at author residue 294.

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed

1d ago

Last success

1d ago

Last latency

660ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "chain_id": {
      "description": "Optional chain ID to filter (e.g., 'A', 'B'). If not provided, all chains are returned.",
      "type": [
        "string",
        "null"
      ]
    },
    "pdb_id": {
      "description": "PDB entry ID (4-character code). Examples: '4hhb', '3ert', '1tup', '6lu7'. Case-insensitive.",
      "type": "string"
    }
  },
  "required": [
    "pdb_id"
  ],
  "type": "object"
}

Examples (1)

{
  "pdb_id": "1AKI"
}

Identifiers

Catalog ID

tu_PDBe_get_residue_listing

Tool name

PDBe_get_residue_listing

Added

2026-05-01 00:58Z

Tags

tooluniverse