---
title: "Fetch a resource by ID"
method: GET
path: "/v0.1/discovery/resources/{id}"
tags: ["discovery"]
---

# Fetch a resource by ID

`GET /v0.1/discovery/resources/{id}`

## Request

- Base URL: `https://platform.nypl.org/api`
- URL: `https://platform.nypl.org/api/v0.1/discovery/resources/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/nypl/apis/discovery-api/docs/v0.1/discovery/resources/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch a resource. Note alternate response formats:

`.ntriples, .turtle, .jsonld (default)`

## Path parameters

- `id` string, required

## Query parameters

- `items_size` number
- `items_from` number
- `all_items` boolean
- `item_location` string
- `item_status` string
- `item_format` string

## Response `200`

A single resource

- Resource
  - `@type` string[]: RDF type(s), e.g. "nypl:Item", "nypl:Resource"
  - `@id` string: ID, e.g. "res:105173159"
  - `carrierType` EntityStub[]
    - `@type` string
    - `@id` string
    - `prefLabel` string: Friendly label for this entity
  - `creatorLiteral` string[]: Creator literals
  - `contributorLiteral` string[]: Contributor literals
  - `created` string: Raw, unparsed date string
  - `createdYear` integer: Year of creation
  - `dateStartYear` integer: Start of relevant year range
  - `depiction` string: URL of an image for the resource
  - `description` string: Description of resource
  - `endYear` integer: Ending year of coverage
  - `extent` string[]: Extent (e.g. page count)
  - `holdingCount` integer: Rough number of copies across institutions
  - `issuance` EntityStub[]: Issuance
    - `@type` string
    - `@id` string
    - `prefLabel` string: Friendly label for this entity
  - `items` Item[]: Array of items attached to this bib
    - `@id` string
    - `accessMessage` EntityStub[]: OPAC Access Message
      - `@type` string
      - `@id` string
      - `prefLabel` string: Friendly label for this entity
    - `deliveryLocation` EntityStub[]: Delivery locations
      - `@type` string
      - `@id` string
      - `prefLabel` string: Friendly label for this entity
    - `eddRequestable` boolean: Boolean indicating whether or not item is available for Electronic Document Delivery.
    - `holdingLocation` EntityStub[]: Delivery locations
      - `@type` string
      - `@id` string
      - `prefLabel` string: Friendly label for this entity
    - `idBarcode` string
    - `identifier` string[]: Array of identifiers (e.g. urn:barcode:33433058873765)
    - `owner` EntityStub[]: Owning institution
      - `@type` string
      - `@id` string
      - `prefLabel` string: Friendly label for this entity
    - `physRequestable` boolean: Indiates whether an item is available for a physical hold request
    - `requestable` boolean[]: Boolean indicating whether or not a hold request may be placed on this item based on its status, location, and other concerns.
    - `shelfMark` string[]: Callnumber(s)
    - `specRequestable` boolean: Indicates if an item is requestable through the Aeon interface
    - `status` EntityStub[]: Availability status
      - `@type` string
      - `@id` string
      - `prefLabel` string: Friendly label for this entity
    - `uri` string: Internal identifier for resource
  - `^id` string: Various identifiers given as 'idAcqnum', 'idBarcode', 'idBnum', 'idCallNum', 'idCatnyp', 'idDcc', 'idExhib', 'idHathi', 'idIsbn', 'idIssn', 'idLcc', 'idLccCoarse', 'idMmmsDb', 'idMss', 'idObjNum', 'idOclc', 'idOwi', 'idRlin', 'idUuid'
  - `language` EntityStub[]: Language(s), if known
    - `@type` string
    - `@id` string
    - `prefLabel` string: Friendly label for this entity
  - `materialType` EntityStub[]
    - `@type` string
    - `@id` string
    - `prefLabel` string: Friendly label for this entity
  - `mediaType` EntityStub[]
    - `@type` string
    - `@id` string
    - `prefLabel` string: Friendly label for this entity
  - `note` object[]: Note fields
    - `@type` 'bf:Note'
    - `noteType` string: One of roughly 47 categories of notes (e.g. General Note, Dissertation Note, Data Quality Note., etc.)
    - `label` string: The actual content of the note
  - `numAvailable` integer: Number of items available
  - `placeOfPublication` string[]
  - `prefLabel` string[]: Best title(s)
  - `roles:ROLE` string[]: Contributor literals by ROLE
  - `startYear` integer: Beggining year of coverage
  - `subject` EntityStub[]
    - `@type` string
    - `@id` string
    - `prefLabel` string: Friendly label for this entity
  - `suppressed` boolean: Indicates whether or not resource should be suppressed from view
  - `title` string[]: Title(s)
  - `titleDisplay` string[]: Display title(s)
  - `type` string[]
  - `uri` string: Internal identifier for resource

## Other responses

- `default`: Unexpected error

## Changes

- **2024-10-17** `d9169b76462d`: 6 info
  - added the new optional `query` request parameter `all_items`
  - added the new optional `query` request parameter `item_format`
  - added the new optional `query` request parameter `item_location`
  - added the new optional `query` request parameter `item_status`
  - …2 more

[Operation history](https://skmtc.dev/nypl/apis/discovery-api/changes/v0.1/discovery/resources/:id/get.md)

---

[API](https://skmtc.dev/nypl/apis/discovery-api.md) - [All operations](https://skmtc.dev/nypl/apis/discovery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nypl/apis/discovery-api/revisions/fdf39728bf28?raw)