<!--
{
  "availability" : [
    "VPP License Management: 2.1.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/Get-Your-Books-Metadata",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:vpp:get:v1-catalog-{}-stoken-authenticated-books"
  },
  "title" : "Get Metadata for Your Books"
}
-->

# Get Metadata for Your Books

Fetch metadata for your books by using their identifiers.

## Discussion

### Example Request and Response

**Request:**

```
?ids=431617578&platform=iphone
```

**Response:**

```json
{
    "data": [
        {
            "attributes": {
                "artistName": "Walter Isaacson",
                "artwork": {
                "height": 2131,
                "url": "https://isq11.mzstatic.com/image/thumb/Publication4/v4/3f/33/b5/3f33b53e-78bb-5bb5-4007-09b5a1969842/9781451648553.jpg/{w}x{h}bb.{f}",
                "width": 1399
                },
                "genreNames": [
                    "Biographies & Memoirs",
                    "Books",
                    "Business & Personal Finance",
                    "Management & Leadership",
                    "Computers & Internet",
                    "Computers"
                ],
                "isbn": "9781451648553",
                "name": "Steve Jobs",
                "offers": [
                    {
                        "assets": [
                            {
                                "flavor": "publication",
                                "size": 27582389
                            }
                        ],
                        "buyParams":"productType=PUB&price=14990&salableAdamId=431617578&pricingParameters=STDQ&pg=default&marketType=ENT",
                        "currencyCode": "USD",
                        "price": 14.99,
                        "priceFormatted": "$14.99",
                        "type": "buy"
                    }
                ],
                "url": "https://books.apple.com/us/book/steve-jobs/id431617578",
                "userRating": {
                    "ratingCount": 10,
                    "value": 4.4
                }
            },
            "href": "/v1/catalog/us/books/431617578",
            "id": "431617578",
            "relationships": {
                "genres": {
                    "data": [
                        {
                            "attributes": {
                                "name": "Biographies & Memoirs",
                                "parentId": "38",
                                "parentName": "Books",
                                "url": "https://itunes.apple.com/us/genre/id9008"
                            },
                            "href": "/v1/catalog/us/genres/9008",
                            "id": "9008",
                            "type": "genres"
                        },
                        {
                            "attributes": {
                                "name": "Books",
                                "url": "https://itunes.apple.com/us/genre/id38"
                            },
                            "href": "/v1/catalog/us/genres/38",
                            "id": "38",
                            "type": "genres"
                        },
                        {
                            "attributes": {
                                "name": "Business & Personal Finance",
                                "parentId": "38",
                                "parentName": "Books",
                                "url": "https://itunes.apple.com/us/genre/id9009"
                            },
                            "href": "/v1/catalog/us/genres/9009",
                            "id": "9009",
                            "type": "genres"
                        },
                        {
                            "attributes": {
                                "name": "Management & Leadership",
                                "parentId": "9009",
                                "parentName": "Business & Personal Finance",
                                "url": "https://itunes.apple.com/us/genre/id10014"
                            },
                            "href": "/v1/catalog/us/genres/10014",
                            "id": "10014",
                            "type": "genres"
                        },
                        {
                            "attributes": {
                                "name": "Computers & Internet",
                                "parentId": "38",
                                "parentName": "Books",
                                "url": "https://itunes.apple.com/us/genre/id9027"
                            },
                            "href": "/v1/catalog/us/genres/9027",
                            "id": "9027",
                            "type": "genres"
                        },
                        {
                            "attributes": {
                                "name": "Computers",
                                "parentId": "9027",
                                "parentName": "Computers & Internet",
                                "url": "https://itunes.apple.com/us/genre/id10017"
                            },
                            "href": "/v1/catalog/us/genres/10017",
                            "id": "10017",
                            "type": "genres"
                        }
                    ],
                    "href": "/v1/catalog/us/books/431617578/genres"
                }
            },
            "type": "books"
        }
    ]
}
```

## Topics

### Responses

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

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)