---
title: "Get a list of unreleased structures with descriptions."
method: GET
path: "/rest/v1/holdings/unreleased"
tags: ["Repository Holdings Service"]
---

# Get a list of unreleased structures with descriptions.

`GET /rest/v1/holdings/unreleased`

## Request

- Base URL: `https://data.rcsb.org`
- URL: `https://data.rcsb.org/rest/v1/holdings/unreleased`
- Auth: none declared
- TypeScript: <https://skmtc.dev/rcsb/apis/rcsb-pdb-data-api/docs/rest/v1/holdings/unreleased/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `ids` string, required

## Response `200`

OK

- UnreleasedEntry[]
  - `rcsb_repository_holdings_prerelease` RcsbRepositoryHoldingsPrerelease[]
    - `entity_id` string, required: The polymer entity identifier.
    - `seq_one_letter_code` string: Chemical sequence expressed as string of one-letter amino acid codes. Modifications and non-standard amino acids are represented parenthetically as 3-letter codes.
  - `rcsb_repository_holdings_unreleased` RcsbRepositoryHoldingsUnreleased
    - `audit_authors` string[]: Names of the authors of the entry.
    - `author_prerelease_sequence_status` 'HOLD FOR PUBLICATION' | 'HOLD FOR RELEASE' | 'RELEASE IMMEDIATELY' | 'RELEASE NOW': The prerelease status for the molecular sequences for the entry .
    - `deposit_date` string, date-time: The entry deposition date.
    - `deposit_date_coordinates` string, date-time: The deposition date of entry coordinate data.
    - `deposit_date_nmr_restraints` string, date-time: The deposition date of entry NMR restraint data.
    - `deposit_date_structure_factors` string, date-time: The deposition date of entry structure factor data.
    - `hold_date_coordinates` string, date-time: The embargo date of entry coordinate data.
    - `hold_date_nmr_restraints` string, date-time: The embargo date of entry NMR restraint data.
    - `hold_date_structure_factors` string, date-time: The embargo date of entry structure factor data.
    - `prerelease_sequence_available_flag` 'N' | 'Y': A flag to indicate the molecular sequences for an unreleased entry are available.
    - `release_date` string, date-time: The release date for the entry.
    - `status_code` 'AUCO' | 'AUTH' | 'HOLD' | 'HPUB' | 'POLC' | 'PROC' | 'REFI' | 'REPL' | 'WAIT' | 'WDRN': The release status for the entry.
    - `title` string: The entry title.
  - `rcsb_repository_holdings_unreleased_entry_container_identifiers` RcsbRepositoryHoldingsUnreleasedEntryContainerIdentifiers
    - `entry_id` string, required: The PDB entry accession code.
    - `rcsb_id` string: The RCSB entry identifier.
    - `update_id` string: Identifier for the data exchange status record.
  - `rcsb_id` string, required: The RCSB entry identifier.

## Other responses

- `204`: No Content. Request did not return any results.
- `400`: Bad Request. Parameter input is not valid.
- `404`: Not found. Requested resource was not found.
- `500`: Internal Server Error. Server encountered unexpected error.

---

[API](https://skmtc.dev/rcsb/apis/rcsb-pdb-data-api.md) - [All operations](https://skmtc.dev/rcsb/apis/rcsb-pdb-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rcsb/apis/rcsb-pdb-data-api/revisions/60c1f3a4b5b1?raw)