---
title: "Get book details"
method: GET
path: "/book/details/{bookSlug}"
tags: ["Books"]
---

# Get book details

`GET /book/details/{bookSlug}`

Retrieve detailed information about a specific book including content and metadata

## Path parameters

- `bookSlug` string, required

## Query parameters

- `locale` 'en' | 'ar'

## Response `200`

Book details retrieved successfully

- BookDetailsResponse
  - `book` Book, required
    - `id` string, required — Unique identifier for the book
    - `slug` string, required — URL-friendly identifier
    - `primaryName` string, required — Primary name of the book
    - `secondaryName` string — Secondary name of the book
    - `author` Author, required
      - `id` string, required — Unique identifier for the author
      - `slug` string, required — URL-friendly identifier
      - `primaryName` string, required — Primary name of the author
      - `secondaryName` string — Secondary name of the author
      - `year` integer — Year of birth/death
      - `locations` Location[]
        - `id` string, required — Unique identifier for the location
        - `name` string, required — Name of the location
        - `region` Region
          - `id` string, required — Unique identifier for the region
          - `slug` string, required — URL-friendly identifier
          - `name` string, required — Name of the region
    - `year` integer — Year of publication
    - `versions` BookVersion[]
      - `id` string, required — Unique identifier for the version
      - `value` string, required — Version identifier
      - `source` string, required — Source of the version
      - `aiSupported` boolean — Whether AI is supported for this version
      - `keywordSupported` boolean — Whether keyword search is supported
  - `headings` object[]
    - `level` integer
    - `text` string
    - `page` integer
  - `publication_details` object
    - `publisher` string
    - `year` integer

## Other responses

- `400` — Bad request - book has no versions or AI not supported
- `404` — Book not found

---

[API](https://skmtc.dev/usul/apis/usul-api.md) · [All operations](https://skmtc.dev/usul/apis/usul-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usul/usul-api/revisions/b4f2df3e5842/schema)
