<!--
{
  "availability" : [
    "VPP License Management: 2.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/GET-v1-catalog-_storefront_-books-_id_",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:vpp:get:v1-catalog-{}-books-{}"
  },
  "title" : "Get Metadata for a Catalog Book"
}
-->

# Get Metadata for a Catalog Book

Fetch metadata for a book from the catalog by using its identifier.

## Discussion

### Example Request and Response

**Request:**

```
/book_id_123?platform=iphone
```

**Response:**

```json
{
  "data":[
    {
        "id": "book_id_123",
        "type": "books",
        "href": "/v1/catalog/us/books/book_id_123?l=en-US",
        "attributes": {
          "offers": [
            {
              "buyParams": "productType=PUB&price=13990&salableAdamId=book_id_123&pricingParameters=STDQ&pg=default&marketType=ENT",
              "type": "buy",
              "priceFormatted": "$13.99",
              "price": 13.99,
              "currencyCode": "USD",
              "assets": [
                {
                  "flavor": "publication",
                  "size": 98316906
                }
              ]
            }
          ],
          "genreNames": [
            "Art & Architecture",
            "Books",
            "Arts & Entertainment",
            "Health, Mind & Body",
            "Self-Improvement"
          ],
          "isbn": "123456789",
          "name": "A Very Famous Book",
          "artistName": "FamousAuthor",
          "artwork": {
            "width": 2213,
            "height": 2400,
            "url": "IMAGE_URL",
            "bgColor": "b7c2c4",
            "textColor1": "0e0c11",
            "textColor2": "301f1b",
            "textColor3": "303035",
            "textColor4": "4b403d"
          },
          "url": "https://books.apple.com/us/book/foo-bar/id123456",
          "userRating": {
            "value": 0,
            "ratingCount": 0
          }
        },
        "relationships": {
          "genres": {
            "href": "/v1/catalog/us/books/book_id_123/genres?l=en-US",
            "data": [
              {
                "id": "10002",
                "type": "genres",
                "href": "/v1/catalog/us/genres/10002?l=en-US",
                "attributes": {
                  "parentName": "Arts & Entertainment",
                  "name": "Art & Architecture",
                  "parentId": "9007",
                  "url": "https://itunes.apple.com/us/genre/id10002"
                }
              },
              {
                "id": "38",
                "type": "genres",
                "href": "/v1/catalog/us/genres/38?l=en-US",
                "attributes": {
                  "name": "Books",
                  "url": "https://itunes.apple.com/us/genre/id38"
                }
              }
            ]
          }
        }
      }
  ]
}
```

## Topics

### Responses

[`object BooksResponse`](/documentation/DeviceManagement/BooksResponse)

A response that contains the resource objects for the request.

[`object UnauthorizedResponse`](/documentation/DeviceManagement/UnauthorizedResponse)

A response that indicates an incorrect authorization header.

[`object ErrorsResponse`](/documentation/DeviceManagement/ErrorsResponse)

The collection of errors that occurred while processing the request.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)