/rcsb/entries/search

POST /api/rcsb/entries/search

Price: 1 credit

Search PDB structures by text and by method, resolution, organism, ligand and date filters

How to use it

`query` is free text over the whole record while every other field is an exact filter, and they are combined with AND, so a filter-only request needs no `query`. Resolution filters silently exclude NMR structures, which have no resolution at all. `taxonomy_id` matches anywhere in the lineage, so 40674 returns every mammal while `organism` pins one species name. Rows are full structure records, identical to what the single-entry endpoint returns.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• query string nullable — Free text matched across titles, keywords, authors, ligands and annotations (examples: "hemoglobin", "SARS-CoV-2 spike"; minLength: 1)
• structure_title string nullable — Words that must appear in the structure title (examples: "kinase"; minLength: 1)
• keyword_category string nullable — Words from the deposited keyword category of the structure (examples: "TRANSFERASE"; minLength: 1)
• author string nullable — Depositing author, written as the source does: surname, initials (examples: "Perutz, M.F."; minLength: 1)
• experimental_method string nullable — Experimental technique the structure was solved by (one of: "X-RAY DIFFRACTION", "ELECTRON MICROSCOPY", "SOLUTION NMR", "ELECTRON CRYSTALLOGRAPHY", "NEUTRON DIFFRACTION", "SOLID-STATE NMR", "SOLUTION SCATTERING", "FIBER DIFFRACTION", "POWDER DIFFRACTION", "EPR", "THEORETICAL MODEL", "INFRARED SPECTROSCOPY", "FLUORESCENCE TRANSFER")
• polymer_composition string nullable — Kinds of polymer chain the structure contains (one of: "homomeric protein", "heteromeric protein", "protein/NA", "protein/oligosaccharide", "DNA", "RNA", "protein/NA/oligosaccharide", "NA-hybrid", "DNA/RNA", "other type pair", "oligosaccharide", "NA/oligosaccharide", "other", "other type composition")
• organism string nullable — Scientific name of the source organism of a chain (examples: "Homo sapiens"; minLength: 1)
• taxonomy_id string nullable — NCBI taxonomy identifier matched anywhere in the source organism lineage, so a clade identifier also matches every species below it (examples: "9606", "40674"; minLength: 1)
• uniprot_accession string nullable — Keep structures whose chains map to this UniProt accession (examples: "P69905"; minLength: 1)
• ligand_id string nullable — PDB chemical component code that must be bound in the structure (examples: "HEM", "ATP"; minLength: 1)
• ec_number string nullable — Enzyme Commission number of a chain (examples: "2.7.11.1"; minLength: 1)
• min_resolution number nullable — Lowest resolution number to keep, in angstroms, so the finest structure kept is this value and anything finer than it is dropped (examples: 1.5; min: 0)
• max_resolution number nullable — Highest resolution number to keep, in angstroms, so the coarsest structure kept is this value and anything coarser than it is dropped (examples: 2; min: 0)
• min_molecular_weight number nullable — Lowest structure molecular weight, in kilodaltons (examples: 50; min: 0)
• max_molecular_weight number nullable — Highest structure molecular weight, in kilodaltons (examples: 500; min: 0)
• min_polymer_entity_count integer nullable — Fewest distinct polymer chains the structure must have (examples: 2; min: 1)
• released_after string nullable — Keep structures first released on or after this date, written as YYYY-MM-DD (examples: "2020-01-01"; minLength: 1)
• released_before string nullable — Keep structures first released on or before this date, written as YYYY-MM-DD (examples: "2023-12-31"; minLength: 1)
• deposited_after string nullable — Keep structures deposited on or after this date, written as YYYY-MM-DD (examples: "2020-01-01"; minLength: 1)
• deposited_before string nullable — Keep structures deposited on or before this date, written as YYYY-MM-DD (examples: "2023-12-31"; minLength: 1)
• sort string nullable — Result ordering (one of: "score", "-rcsb_accession_info.initial_release_date", "rcsb_accession_info.initial_release_date", "-rcsb_accession_info.deposit_date", "rcsb_accession_info.deposit_date", "rcsb_entry_info.resolution_combined", "-rcsb_entry_info.resolution_combined", "-rcsb_entry_info.molecular_weight", "rcsb_entry_info.molecular_weight")
• count integer required — Max number of results (min: 1; max: 500)

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 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit 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 — The entity was not found, or a precondition failed 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 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 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 Wait at least 30 seconds, then retry.

Response 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.