titles/{id}/copies

Returns the list of copies for a given title, specified by title ID, with basic information about each copy.

Resource URL

https://api.bibliocommons.com/v1/titles/{id}/copies

Request Parameters

Parameter Type Description Default Required?
id String The title ID. N/A Yes

Response Fields

Response Field Type Description Returned
collection String The collection the copy belongs to. Always
call number String The call number of the copy. Always
library_status String The library-specific status string. Always
location Object The library location the copy belongs to. Always
id String The ID of the location. Always
name String The user-friendly name of the location. Always
status Object The normalized BiblioCommons status. Always
id String The ID of the status. Always
name String The user-friendly name of the status. Always

Example Request

GET https://api.bibliocommons.com/v1/titles/13312341/copies?api_key={key}

Response:

{
  "copies": [
    {
      "location": {
        "id": "MA",
        "name": "Main Branch"
      },
      "collection": "Teen Paperbacks",
      "call_number": "Sleat",
      "status": {
        "id": "AVAILABLE",
        "name": "Available"
      }, 
      "library_status": "In"
    }
  ]
}