# /rcsb/entries

`POST /api/rcsb/entries`

Price: 1 credit

Get one PDB structure entry by its four-character identifier

## How to use it

The identifier is the four-character PDB code and is matched case-insensitively; the extended `pdb_00004hhb` form is not accepted here. Which experimental block is populated follows the method: an X-ray entry carries `crystal`, `refinement` and `diffraction`, a cryo-EM entry carries `electron_microscopy` and often no resolution from refinement, an NMR entry carries `nmr` and no resolution at all. `polymer_entity_ids` and `assembly_ids` are what the polymer-entity and assembly endpoints take.

## Parameters

- `access-token` (string, required)

## Request body

- `timeout` (integer) — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
- `entry` (string, required) — Four-character PDB identifier, or an RCSB structure URL containing one (examples: "4HHB", "https://www.rcsb.org/structure/4HHB"; minLength: 1)

## Response

### 200 — Successful Response

- `@type` (string) (default: "RcsbEntry")
- `id` (string) (default: "")
- `keywords` (string) (default: "")
- `keyword_category` (string) (default: "")
- `experimental_methods` (array) (default: [])
- `crystal_count` (integer, nullable)
- `resolutions` (array) (default: [])
- `deposit_date` (string) (default: "")
- `release_date` (string) (default: "")
- `revision_date` (string) (default: "")
- `status` (string) (default: "")
- `major_revision` (integer, nullable)
- `minor_revision` (integer, nullable)
- `has_released_experimental_data` (boolean, nullable)
- `received_date` (string) (default: "")
- `deposit_site` (string) (default: "")
- `process_site` (string) (default: "")
- `structure_factor_status` (string) (default: "")
- `is_pdb_format_compatible` (boolean, nullable)
- `is_structural_genomics` (boolean, nullable)
- `is_casp_target` (boolean, nullable)
- `structural_genomics_center` (string) (default: "")
- `structural_genomics_project` (string) (default: "")
- `pubmed_id` (string) (default: "")
- `assembly_ids` (array) (default: [])
- `entity_ids` (array) (default: [])
- `polymer_entity_ids` (array) (default: [])
- `nonpolymer_entity_ids` (array) (default: [])
- `branched_entity_ids` (array) (default: [])
- `model_ids` (array) (default: [])
- `emdb_ids` (array) (default: [])
- `related_emdb_ids` (array) (default: [])
- `authors` (array) (default: [])
  - `@type` (string) (default: "RcsbEntryAuthor")
  - `name` (string) (default: "")
  - `orcid` (string) (default: "")
- `primary_citation` (object, nullable)
  - `@type` (string) (default: "RcsbCitation")
  - `id` (string) (default: "")
  - `journal` (string) (default: "")
  - `journal_abbreviation` (string) (default: "")
  - `authors` (array) (default: [])
  - `author_orcids` (array) (default: [])
  - `year` (integer, nullable)
  - `volume` (string) (default: "")
  - `first_page` (string) (default: "")
  - `last_page` (string) (default: "")
  - `doi` (string) (default: "")
  - `pubmed_id` (string) (default: "")
  - `issn` (string) (default: "")
  - `astm_id` (string) (default: "")
  - `csd_id` (string) (default: "")
  - `country` (string) (default: "")
  - `book_publisher` (string) (default: "")
  - `is_primary` (boolean, nullable)
- `citations` (array) (default: [])
  - `@type` (string) (default: "RcsbCitation")
  - `id` (string) (default: "")
  - `journal` (string) (default: "")
  - `journal_abbreviation` (string) (default: "")
  - `authors` (array) (default: [])
  - `author_orcids` (array) (default: [])
  - `year` (integer, nullable)
  - `volume` (string) (default: "")
  - `first_page` (string) (default: "")
  - `last_page` (string) (default: "")
  - `doi` (string) (default: "")
  - `pubmed_id` (string) (default: "")
  - `issn` (string) (default: "")
  - `astm_id` (string) (default: "")
  - `csd_id` (string) (default: "")
  - `country` (string) (default: "")
  - `book_publisher` (string) (default: "")
  - `is_primary` (boolean, nullable)
- `funding` (array) (default: [])
  - `@type` (string) (default: "RcsbFunding")
  - `organization` (string) (default: "")
  - `country` (string) (default: "")
  - `grant_number` (string) (default: "")
- `database_references` (array) (default: [])
  - `@type` (string) (default: "RcsbDatabaseReference")
  - `database_id` (string) (default: "")
  - `code` (string) (default: "")
  - `accession` (string) (default: "")
  - `doi` (string) (default: "")
- `related_entries` (array) (default: [])
  - `@type` (string) (default: "RcsbRelatedEntry")
  - `database_name` (string) (default: "")
  - `database_entry_id` (string) (default: "")
  - `content_type` (string) (default: "")
  - `details` (string) (default: "")
- `external_references` (array) (default: [])
  - `@type` (string) (default: "RcsbExternalReference")
  - `id` (string) (default: "")
  - `type` (string) (default: "")
  - `url` (string) (default: "")
- `revision_history` (array) (default: [])
  - `@type` (string) (default: "RcsbRevision")
  - `ordinal` (integer, nullable)
  - `revision_date` (string) (default: "")
  - `major_revision` (integer, nullable)
  - `minor_revision` (integer, nullable)
  - `data_content_type` (string) (default: "")
- `revision_details` (array) (default: [])
  - `@type` (string) (default: "RcsbRevisionDetail")
  - `ordinal` (integer, nullable)
  - `revision_ordinal` (integer, nullable)
  - `provider` (string) (default: "")
  - `type` (string) (default: "")
  - `data_content_type` (string) (default: "")
  - `description` (string) (default: "")
- `software` (array) (default: [])
  - `@type` (string) (default: "RcsbSoftware")
  - `name` (string) (default: "")
  - `version` (string) (default: "")
  - `classification` (string) (default: "")
  - `type` (string) (default: "")
  - `language` (string) (default: "")
  - `url` (string) (default: "")
  - `contact_author` (string) (default: "")
  - `contact_author_email` (string) (default: "")
  - `date` (string) (default: "")
- `supersede_records` (array) (default: [])
  - `@type` (string) (default: "RcsbSupersedeRecord")
  - `entry_id` (string) (default: "")
  - `replaced_entry_id` (string) (default: "")
- `initial_refinement_models` (array) (default: [])
  - `@type` (string) (default: "RcsbInitialRefinementModel")
  - `type` (string) (default: "")
  - `source_name` (string) (default: "")
  - `accession_code` (string) (default: "")
- `info` (object, nullable)
  - `@type` (string) (default: "RcsbEntryInfo")
  - `experimental_method` (string) (default: "")
  - `experimental_method_count` (integer, nullable)
  - `structure_determination_methodology` (string) (default: "")
  - `polymer_composition` (string) (default: "")
  - `selected_polymer_entity_types` (string) (default: "")
  - `na_polymer_entity_types` (string) (default: "")
  - `molecular_weight` (number, nullable)
  - `assembly_count` (integer, nullable)
  - `entity_count` (integer, nullable)
  - `polymer_entity_count` (integer, nullable)
  - `protein_entity_count` (integer, nullable)
  - `dna_entity_count` (integer, nullable)
  - `rna_entity_count` (integer, nullable)
  - `nucleic_acid_entity_count` (integer, nullable)
  - `nucleic_acid_hybrid_entity_count` (integer, nullable)
  - `nonpolymer_entity_count` (integer, nullable)
  - `branched_entity_count` (integer, nullable)
  - `solvent_entity_count` (integer, nullable)
  - `polymer_entity_taxonomy_count` (integer, nullable)
  - `deposited_model_count` (integer, nullable)
  - `deposited_atom_count` (integer, nullable)
  - `deposited_hydrogen_atom_count` (integer, nullable)
  - `deposited_solvent_atom_count` (integer, nullable)
  - `deposited_deuterated_water_count` (integer, nullable)
  - `deposited_polymer_monomer_count` (integer, nullable)
  - `deposited_modeled_polymer_monomer_count` (integer, nullable)
  - `deposited_unmodeled_polymer_monomer_count` (integer, nullable)
  - `deposited_polymer_entity_instance_count` (integer, nullable)
  - `deposited_nonpolymer_entity_instance_count` (integer, nullable)
  - `disulfide_bond_count` (integer, nullable)
  - `cis_peptide_count` (integer, nullable)
  - `inter_molecular_covalent_bond_count` (integer, nullable)
  - `inter_molecular_metallic_bond_count` (integer, nullable)
  - `polymer_molecular_weight_minimum` (number, nullable)
  - `polymer_molecular_weight_maximum` (number, nullable)
  - `polymer_monomer_count_minimum` (integer, nullable)
  - `polymer_monomer_count_maximum` (integer, nullable)
  - `nonpolymer_molecular_weight_minimum` (number, nullable)
  - `nonpolymer_molecular_weight_maximum` (number, nullable)
  - `branched_molecular_weight_minimum` (number, nullable)
  - `branched_molecular_weight_maximum` (number, nullable)
  - `nucleic_acid_features_combined` (array) (default: [])
  - `nonpolymer_bound_components` (array) (default: [])
  - `software_programs_combined` (array) (default: [])
  - `diffraction_resolution_high` (number, nullable)
  - `radiation_wavelength_minimum` (number, nullable)
  - `radiation_wavelength_maximum` (number, nullable)
  - `structure_determination_methodology_priority` (integer, nullable)
- `crystal` (object, nullable)
  - `@type` (string) (default: "RcsbCrystal")
  - `length_a` (number, nullable)
  - `length_b` (number, nullable)
  - `length_c` (number, nullable)
  - `angle_alpha` (number, nullable)
  - `angle_beta` (number, nullable)
  - `angle_gamma` (number, nullable)
  - `volume` (number, nullable)
  - `molecules_per_unit_cell` (integer, nullable)
  - `space_group_name` (string) (default: "")
  - `space_group_number` (integer, nullable)
  - `space_group_hall` (string) (default: "")
  - `cell_setting` (string) (default: "")
  - `density_matthews` (number, nullable)
  - `density_percent_solvent` (number, nullable)
  - `mosaicity` (number, nullable)
  - `growth_method` (string) (default: "")
  - `growth_ph` (number, nullable)
  - `growth_ph_range` (string) (default: "")
  - `growth_temperature` (number, nullable)
  - `growth_temperature_details` (string) (default: "")
  - `growth_details` (string) (default: "")
  - `description` (string) (default: "")
- `refinement` (object, nullable)
  - `@type` (string) (default: "RcsbRefinement")
  - `resolution_high` (number, nullable)
  - `resolution_low` (number, nullable)
  - `r_work` (number, nullable)
  - `r_free` (number, nullable)
  - `r_free_error` (number, nullable)
  - `r_observed` (number, nullable)
  - `b_factor_mean` (number, nullable)
  - `b_factor_min` (number, nullable)
  - `b_factor_max` (number, nullable)
  - `reflection_count_observed` (integer, nullable)
  - `reflection_count_work` (integer, nullable)
  - `reflection_count_free` (integer, nullable)
  - `percent_reflections_observed` (number, nullable)
  - `percent_reflections_free` (number, nullable)
  - `method_to_determine_structure` (string) (default: "")
  - `cross_validation_method` (string) (default: "")
  - `stereochemistry_target_values` (string) (default: "")
  - `solvent_model_details` (string) (default: "")
  - `overall_phase_error` (number, nullable)
  - `overall_su_ml` (number, nullable)
  - `sigma_f_cutoff` (number, nullable)
  - `free_reflection_selection_details` (string) (default: "")
  - `solvent_vdw_probe_radii` (number, nullable)
  - `solvent_shrinkage_radii` (number, nullable)
  - `solvent_model_parameter_ksol` (number, nullable)
  - `solvent_model_parameter_bsol` (number, nullable)
  - `luzzati_coordinate_error` (number, nullable)
  - `luzzati_coordinate_error_free` (number, nullable)
  - `luzzati_sigma_a` (number, nullable)
  - `luzzati_resolution_low` (number, nullable)
  - `atom_count_total` (integer, nullable)
  - `atom_count_protein` (integer, nullable)
  - `atom_count_nucleic_acid` (integer, nullable)
  - `atom_count_ligand` (integer, nullable)
  - `atom_count_solvent` (integer, nullable)
  - `residue_count_total` (integer, nullable)
  - `b_factor_mean_ligand` (number, nullable)
  - `b_factor_mean_solvent` (number, nullable)
  - `isotropic_thermal_model` (string) (default: "")
  - `starting_model` (string) (default: "")
  - `r_all` (number, nullable)
  - `reflection_count_all` (integer, nullable)
  - `parameter_count` (integer, nullable)
  - `restraint_count` (integer, nullable)
  - `correlation_coefficient_fo_to_fc` (number, nullable)
  - `correlation_coefficient_fo_to_fc_free` (number, nullable)
  - `overall_fom_work_r_set` (number, nullable)
  - `overall_su_b` (number, nullable)
  - `overall_esu_r` (number, nullable)
  - `overall_esu_r_free` (number, nullable)
  - `sigma_i_cutoff` (number, nullable)
  - `data_cutoff_high_abs_f` (number, nullable)
  - `data_cutoff_high_rms_abs_f` (number, nullable)
  - `data_cutoff_low_abs_f` (number, nullable)
  - `solvent_ion_probe_radii` (number, nullable)
  - `tls_residual_adp_flag` (string) (default: "")
  - `anisotropic_b_1_1` (number, nullable)
  - `anisotropic_b_1_2` (number, nullable)
  - `anisotropic_b_1_3` (number, nullable)
  - `anisotropic_b_2_2` (number, nullable)
  - `anisotropic_b_2_3` (number, nullable)
  - `anisotropic_b_3_3` (number, nullable)
  - `luzzati_sigma_a_free` (number, nullable)
  - `occupancy_min` (number, nullable)
  - `occupancy_max` (number, nullable)
  - `weighted_r_work` (number, nullable)
  - `weighted_r_free` (number, nullable)
  - `average_fsc_work` (number, nullable)
  - `average_fsc_free` (number, nullable)
  - `overall_su_r_free` (number, nullable)
  - `overall_su_r_cruickshank_dpi` (number, nullable)
  - `overall_su_r_free_cruickshank_dpi` (number, nullable)
  - `overall_su_r_blow_dpi` (number, nullable)
  - `overall_su_r_free_blow_dpi` (number, nullable)
  - `disordered_residue_count` (integer, nullable)
  - `occupancy_sum_hydrogen` (number, nullable)
  - `occupancy_sum_non_hydrogen` (number, nullable)
  - `details` (string) (default: "")
- `diffraction` (object, nullable)
  - `@type` (string) (default: "RcsbDiffraction")
  - `ambient_temperature` (number, nullable)
  - `is_serial_crystallography` (boolean, nullable)
  - `detector` (string) (default: "")
  - `detector_type` (string) (default: "")
  - `detector_details` (string) (default: "")
  - `collection_date` (string) (default: "")
  - `source` (string) (default: "")
  - `source_type` (string) (default: "")
  - `synchrotron_site` (string) (default: "")
  - `synchrotron_beamline` (string) (default: "")
  - `wavelengths` (array) (default: [])
  - `radiation_protocol` (string) (default: "")
  - `scattering_type` (string) (default: "")
  - `monochromator` (string) (default: "")
  - `resolution_high` (number, nullable)
  - `resolution_low` (number, nullable)
  - `reflection_count_observed` (integer, nullable)
  - `percent_possible_observed` (number, nullable)
  - `redundancy` (number, nullable)
  - `r_merge` (number, nullable)
  - `r_pim` (number, nullable)
  - `cc_half` (number, nullable)
  - `net_intensity_over_sigma` (number, nullable)
  - `wilson_b_estimate` (number, nullable)
  - `r_rim` (number, nullable)
  - `chi_squared` (number, nullable)
  - `measured_reflection_count` (integer, nullable)
  - `monochromatic_or_laue` (string) (default: "")
  - `observed_criterion_sigma_intensity` (number, nullable)
  - `r_sym` (number, nullable)
  - `ambient_temperature_details` (string) (default: "")
  - `reflection_count_all` (integer, nullable)
  - `observed_criterion_sigma_amplitude` (number, nullable)
  - `observed_criterion_amplitude_max` (number, nullable)
  - `observed_criterion_amplitude_min` (number, nullable)
  - `observed_criterion_intensity_max` (number, nullable)
  - `observed_criterion_intensity_min` (number, nullable)
  - `scaling_rejects` (integer, nullable)
  - `r_merge_amplitude` (number, nullable)
  - `net_intensity_over_average_sigma` (number, nullable)
  - `r_split` (number, nullable)
- `electron_microscopy` (object, nullable)
  - `@type` (string) (default: "RcsbElectronMicroscopy")
  - `reconstruction_method` (string) (default: "")
  - `aggregation_state` (string) (default: "")
  - `resolution` (number, nullable)
  - `resolution_method` (string) (default: "")
  - `symmetry_type` (string) (default: "")
  - `particle_count` (integer, nullable)
  - `selected_particle_count` (integer, nullable)
  - `microscope_model` (string) (default: "")
  - `electron_source` (string) (default: "")
  - `accelerating_voltage` (number, nullable)
  - `illumination_mode` (string) (default: "")
  - `imaging_mode` (string) (default: "")
  - `nominal_magnification` (number, nullable)
  - `nominal_defocus_min` (number, nullable)
  - `nominal_defocus_max` (number, nullable)
  - `detector_model` (string) (default: "")
  - `image_count` (integer, nullable)
  - `average_electron_dose_per_image` (number, nullable)
  - `ctf_correction_type` (string) (default: "")
  - `point_symmetry` (string) (default: "")
  - `cryogen_name` (string) (default: "")
  - `is_vitrified` (boolean, nullable)
  - `is_stained` (boolean, nullable)
  - `is_embedded` (boolean, nullable)
  - `is_shadowed` (boolean, nullable)
  - `assembly_names` (array) (default: [])
  - `assembly_types` (array) (default: [])
  - `assembly_sources` (array) (default: [])
  - `software` (array) (default: [])
    - `@type` (string) (default: "RcsbSoftware")
    - `name` (string) (default: "")
    - `version` (string) (default: "")
    - `classification` (string) (default: "")
    - `type` (string) (default: "")
    - `language` (string) (default: "")
    - `url` (string) (default: "")
    - `contact_author` (string) (default: "")
    - `contact_author_email` (string) (default: "")
    - `date` (string) (default: "")
  - `reconstruction_algorithm` (string) (default: "")
  - `class_average_count` (integer, nullable)
  - `specimen_concentration` (number, nullable)
  - `specimen_holder_model` (string) (default: "")
  - `alignment_procedure` (string) (default: "")
  - `c2_aperture_diameter` (number, nullable)
  - `nominal_cs` (number, nullable)
  - `calibrated_defocus_min` (number, nullable)
  - `calibrated_defocus_max` (number, nullable)
  - `recording_temperature_minimum` (number, nullable)
  - `recording_temperature_maximum` (number, nullable)
  - `tilt_angle_min` (number, nullable)
  - `tilt_angle_max` (number, nullable)
  - `cryogen_in_microscope` (string) (default: "")
  - `detector_mode` (string) (default: "")
  - `average_exposure_time` (number, nullable)
  - `diffraction_image_count` (integer, nullable)
  - `imaged_grid_count` (integer, nullable)
  - `vitrification_instrument` (string) (default: "")
  - `vitrification_humidity` (number, nullable)
  - `vitrification_chamber_temperature` (number, nullable)
  - `embedding_material` (string) (default: "")
  - `staining_material` (string) (default: "")
  - `staining_type` (string) (default: "")
  - `fitting_details` (string) (default: "")
  - `fitting_protocol` (string) (default: "")
  - `fitting_space` (string) (default: "")
  - `fitting_target_criteria` (string) (default: "")
  - `fitting_overall_b_value` (number, nullable)
  - `fitted_models` (array) (default: [])
    - `@type` (string) (default: "RcsbEmFittedModel")
    - `pdb_entry_id` (string) (default: "")
    - `pdb_chain_id` (string) (default: "")
    - `pdb_chain_residue_range` (string) (default: "")
    - `details` (string) (default: "")
  - `crystal_entities` (array) (default: [])
    - `@type` (string) (default: "RcsbEmCrystalEntity")
    - `dimensionality` (integer, nullable)
    - `space_group_name` (string) (default: "")
    - `space_group_number` (integer, nullable)
    - `length_a` (number, nullable)
    - `length_b` (number, nullable)
    - `length_c` (number, nullable)
    - `angle_alpha` (number, nullable)
    - `angle_beta` (number, nullable)
    - `angle_gamma` (number, nullable)
    - `c_sampling_length` (number, nullable)
  - `helical_entities` (array) (default: [])
    - `@type` (string) (default: "RcsbEmHelicalEntity")
    - `angular_rotation_per_subunit` (number, nullable)
    - `axial_rise_per_subunit` (number, nullable)
    - `axial_symmetry` (string) (default: "")
  - `diffraction` (object, nullable)
    - `@type` (string) (default: "RcsbEmDiffraction")
    - `camera_length` (number, nullable)
    - `resolution_high` (number, nullable)
    - `fourier_space_coverage` (number, nullable)
    - `measured_intensity_count` (integer, nullable)
    - `structure_factor_count` (integer, nullable)
    - `overall_phase_error` (number, nullable)
    - `overall_phase_residual` (number, nullable)
    - `phase_error_rejection_criteria` (string) (default: "")
    - `r_merge` (number, nullable)
    - `r_sym` (number, nullable)
- `nmr` (object, nullable)
  - `@type` (string) (default: "RcsbNmr")
  - `conformers_calculated` (integer, nullable)
  - `conformers_submitted` (integer, nullable)
  - `conformer_selection_criteria` (string) (default: "")
  - `representative_conformer` (string) (default: "")
  - `representative_selection_criteria` (string) (default: "")
  - `refinement_method` (string) (default: "")
  - `refinement_details` (string) (default: "")
  - `experiment_types` (array) (default: [])
  - `sample_contents` (string) (default: "")
  - `sample_solvent_system` (string) (default: "")
  - `sample_type` (string) (default: "")
  - `sample_states` (array) (default: [])
  - `ph` (number, nullable)
  - `ph_units` (string) (default: "")
  - `temperature` (number, nullable)
  - `temperature_units` (string) (default: "")
  - `pressure` (string) (default: "")
  - `pressure_units` (string) (default: "")
  - `ionic_strength` (string) (default: "")
  - `ionic_strength_units` (string) (default: "")
  - `sample_conditions_label` (string) (default: "")
  - `spectrometer_manufacturers` (array) (default: [])
  - `spectrometer_models` (array) (default: [])
  - `spectrometer_field_strengths` (array) (default: [])
  - `software` (array) (default: [])
    - `@type` (string) (default: "RcsbSoftware")
    - `name` (string) (default: "")
    - `version` (string) (default: "")
    - `classification` (string) (default: "")
    - `type` (string) (default: "")
    - `language` (string) (default: "")
    - `url` (string) (default: "")
    - `contact_author` (string) (default: "")
    - `contact_author_email` (string) (default: "")
    - `date` (string) (default: "")
  - `details` (string) (default: "")
  - `ensemble_representative_conformer` (string) (default: "")
  - `maximum_torsion_angle_constraint_violation` (number, nullable)
  - `ph_error` (number, nullable)
  - `temperature_error` (number, nullable)
  - `ionic_strength_error` (string) (default: "")
  - `pressure_error` (string) (default: "")
- `validation` (object, nullable)
  - `@type` (string) (default: "RcsbValidation")
  - `report_created_date` (string) (default: "")
  - `attempted_validation_steps` (string) (default: "")
  - `clashscore` (number, nullable)
  - `clashscore_full_length` (number, nullable)
  - `bonds_rmsz` (number, nullable)
  - `angles_rmsz` (number, nullable)
  - `percent_ramachandran_outliers` (number, nullable)
  - `percent_rotamer_outliers` (number, nullable)
  - `percent_rsrz_outliers` (number, nullable)
  - `data_completeness` (number, nullable)
  - `intensity_over_sigma` (string) (default: "")
  - `r_free_dcc` (number, nullable)
  - `r_dcc` (number, nullable)
  - `wilson_b_estimate` (number, nullable)
  - `twin_fraction` (string) (default: "")
  - `percent_ramachandran_outliers_full_length` (number, nullable)
  - `percent_rotamer_outliers_full_length` (number, nullable)
  - `b_factor_type` (string) (default: "")
  - `r_free_reflection_count` (integer, nullable)
  - `percent_free_reflections` (number, nullable)
  - `miller_index_count` (integer, nullable)
  - `acentric_outliers` (integer, nullable)
  - `centric_outliers` (integer, nullable)
  - `data_anisotropy` (number, nullable)
  - `wilson_b_anisotropy` (array) (default: [])
  - `eds_r` (number, nullable)
  - `eds_resolution_high` (number, nullable)
  - `eds_resolution_low` (number, nullable)
  - `fo_fc_correlation` (number, nullable)
  - `padilla_yeates_l_mean` (number, nullable)
  - `padilla_yeates_l2_mean` (number, nullable)
  - `bulk_solvent_b` (number, nullable)
  - `bulk_solvent_k` (number, nullable)
  - `translational_ncs_details` (string) (default: "")
  - `atom_inclusion_all_atoms` (number, nullable)
  - `atom_inclusion_backbone` (number, nullable)
  - `q_score` (number, nullable)
  - `primary_map_contour_level` (number, nullable)
  - `chemical_shift_completeness` (number, nullable)
  - `chemical_shift_completeness_full_length` (number, nullable)
  - `nmr_model_consistency` (string) (default: "")
  - `cyrange_domain_count` (integer, nullable)
  - `medoid_model` (string) (default: "")
  - `nmrclust_cluster_count` (integer, nullable)
  - `nmrclust_model_count` (integer, nullable)
  - `nmrclust_outlier_count` (integer, nullable)
  - `nmrclust_representative_model` (string) (default: "")
  - `rna_suiteness` (number, nullable)
  - `eds_r_warning` (string) (default: "")
  - `author_fsc_resolution_halfbit` (number, nullable)
  - `author_fsc_resolution_onebit` (number, nullable)
  - `author_fsc_resolution_threesigma` (number, nullable)
  - `author_fsc_resolution_0_143` (number, nullable)
  - `author_fsc_resolution_0_333` (number, nullable)
  - `author_fsc_resolution_0_5` (number, nullable)
  - `calculated_fsc_resolution_halfbit` (number, nullable)
  - `calculated_fsc_resolution_onebit` (number, nullable)
  - `calculated_fsc_resolution_threesigma` (number, nullable)
  - `calculated_fsc_resolution_0_143` (number, nullable)
  - `calculated_fsc_resolution_0_333` (number, nullable)
  - `calculated_fsc_resolution_0_5` (number, nullable)
- `model_details` (string) (default: "")
- `model_type_details` (string) (default: "")
- `molecular_replacement_status` (string) (default: "")
- `chemical_shift_status` (string) (default: "")
- `binding_affinities` (array) (default: [])
  - `@type` (string) (default: "RcsbBindingAffinity")
  - `component_id` (string) (default: "")
  - `type` (string) (default: "")
  - `value` (number, nullable)
  - `unit` (string) (default: "")
  - `reference_sequence_identity` (number, nullable)
  - `source` (string) (default: "")
  - `url` (string) (default: "")
- `molecule_features` (array) (default: [])
  - `@type` (string) (default: "RcsbMoleculeFeature")
  - `prd_id` (string) (default: "")
  - `name` (string) (default: "")
  - `type` (string) (default: "")
  - `feature_class` (string) (default: "")
  - `details` (string) (default: "")
- `deposit_groups` (array) (default: [])
  - `@type` (string) (default: "RcsbDepositGroup")
  - `group_id` (string) (default: "")
  - `description` (string) (default: "")
  - `type` (string) (default: "")
  - `aggregation_method` (string) (default: "")
- `twin_domains` (array) (default: [])
  - `@type` (string) (default: "RcsbTwinDomain")
  - `domain_id` (string) (default: "")
  - `fraction` (number, nullable)
  - `operator` (string) (default: "")
- `related_experimental_data` (array) (default: [])
  - `@type` (string) (default: "RcsbRelatedExperimentalData")
  - `data_set_type` (string) (default: "")
  - `data_reference` (string) (default: "")
  - `metadata_reference` (string) (default: "")
  - `details` (string) (default: "")
- `serial_crystallography` (object, nullable)
  - `@type` (string) (default: "RcsbSerialCrystallography")
  - `delivery_method` (string) (default: "")
  - `delivery_description` (string) (default: "")
  - `injection_description` (string) (default: "")
  - `injection_preparation` (string) (default: "")
  - `injection_carrier_solvent` (string) (default: "")
  - `injection_crystal_concentration` (number, nullable)
  - `injection_injector_diameter` (number, nullable)
  - `injection_injector_pressure` (number, nullable)
  - `injection_injector_temperature` (number, nullable)
  - `injection_flow_rate` (number, nullable)
  - `injection_jet_diameter` (number, nullable)
  - `injection_filter_size` (number, nullable)
  - `fixed_target_description` (string) (default: "")
  - `fixed_target_sample_holding` (string) (default: "")
  - `fixed_target_support_base` (string) (default: "")
  - `fixed_target_sample_solvent` (string) (default: "")
  - `fixed_target_sample_dehydration_prevention` (string) (default: "")
  - `fixed_target_sample_unit_size` (string) (default: "")
  - `fixed_target_crystals_per_unit` (integer, nullable)
  - `fixed_target_motion_control` (string) (default: "")
  - `fixed_target_velocity_horizontal` (number, nullable)
  - `fixed_target_velocity_vertical` (number, nullable)
  - `fixed_target_details` (string) (default: "")
  - `pulse_energy` (number, nullable)
  - `pulse_duration` (number, nullable)
  - `pulse_photon_energy` (number, nullable)
  - `photons_per_pulse` (number, nullable)
  - `source_size` (number, nullable)
  - `source_distance` (number, nullable)
  - `focal_spot_size` (number, nullable)
  - `collimation` (string) (default: "")
  - `collection_time_total` (number, nullable)
  - `beam_path_type` (string) (default: "")
  - `energy_bandwidth` (number, nullable)
  - `xfel_pulse_repetition_rate` (number, nullable)
  - `crystal_hits` (integer, nullable)
  - `droplet_hits` (integer, nullable)
  - `frame_hits` (integer, nullable)
  - `frames_total` (integer, nullable)
  - `frames_indexed` (integer, nullable)
  - `frames_failed_index` (integer, nullable)
  - `lattices_indexed` (integer, nullable)
  - `xfel_pulse_events` (integer, nullable)
  - `xfel_run_numbers` (string) (default: "")
- `solution_scattering` (array) (default: [])
  - `@type` (string) (default: "RcsbSolutionScattering")
  - `type` (string) (default: "")
  - `source_class` (string) (default: "")
  - `source_type` (string) (default: "")
  - `source_beamline` (string) (default: "")
  - `source_beamline_instrument` (string) (default: "")
  - `detector_type` (string) (default: "")
  - `buffer_name` (string) (default: "")
  - `sample_ph` (number, nullable)
  - `temperature` (number, nullable)
  - `concentration_range` (string) (default: "")
  - `protein_length` (string) (default: "")
  - `time_frame_count` (integer, nullable)
  - `mean_guinier_radius` (number, nullable)
  - `mean_guinier_radius_esd` (number, nullable)
  - `min_mean_cross_sectional_radius_of_gyration` (number, nullable)
  - `min_mean_cross_sectional_radius_of_gyration_esd` (number, nullable)
  - `max_mean_cross_sectional_radius_of_gyration` (number, nullable)
  - `max_mean_cross_sectional_radius_of_gyration_esd` (number, nullable)
  - `data_reduction_software` (array) (default: [])
  - `data_analysis_software` (array) (default: [])
- `solution_scattering_models` (array) (default: [])
  - `@type` (string) (default: "RcsbSolutionScatteringModel")
  - `method` (string) (default: "")
  - `software` (array) (default: [])
  - `software_authors` (array) (default: [])
  - `conformers_calculated` (integer, nullable)
  - `conformers_submitted` (integer, nullable)
  - `representative_conformer` (string) (default: "")
  - `conformer_selection_criteria` (string) (default: "")
  - `fitted_entries` (array) (default: [])
  - `details` (string) (default: "")

## Errors

### 422 — Validation Error

The request body did not validate

What to do: Check the fields against this schema. A URN with the wrong prefix is the most common cause.

- `detail` (array)
  - `loc` (array, required)
  - `msg` (string, required)
  - `type` (string, required)
  - `input` (any)
  - `ctx` (object)

### 408

The request ran past its time limit

What to do: Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.

### 412

Entry not found

What to do: Retrying will not help: either the entity does not exist, or the input points at a different one.

### 429

Too many requests: a rate limit or a usage window is exhausted

What to do: When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.

### 500

Something broke on our side

What to do: Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.

### 529

Rate limit reached, or the endpoint is overloaded

What to do: Wait at least 30 seconds, then retry.

## Response envelope

Success: Array of objects (may be empty if no results)

Error: Error may coexist with partial results if it occurs mid-execution. Check X-Error header and status code.

Every response carries these headers:

- `X-Error` — Error message text (present only on error)
- `X-Request-ID` — Unique request identifier
- `X-Execution-Time` — Execution time in seconds
- `X-Result-Count` — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
- `X-Total-Available-Results` — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
- `X-Warning` — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
- `X-Retry-After` — Seconds to wait before retrying. Present only on 429.