Skip to main content
GET
/
api
/
v1
/
books
/
findById
/
{id}
curl -X GET "https://api.example.com/api/v1/books/findById/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "gender": "Fantasy",
  "author": "J.R.R. Tolkien",
  "image": "https://example.com/covers/lotr.jpg",
  "title": "The Lord of the Rings",
  "subtitle": "The Fellowship of the Ring",
  "publisher": "Allen & Unwin",
  "year": "1954",
  "pages": 423,
  "isbn": "978-0-618-00222-1"
}

Authentication

This endpoint requires a valid JWT token in the Authorization header.
Authorization: Bearer <your_jwt_token>

Path Parameters

id
string
required
The unique identifier (UUID) of the book to retrieve.

Response

id
string
Unique identifier of the book.
gender
string
The genre or category of the book.
author
string
The author’s name.
image
string
URL or path to the book’s cover image.
title
string
The main title of the book.
subtitle
string
The subtitle of the book.
publisher
string
The name of the publisher.
year
string
The publication year of the book.
pages
integer
The number of pages in the book.
isbn
string
The International Standard Book Number (ISBN).
curl -X GET "https://api.example.com/api/v1/books/findById/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "gender": "Fantasy",
  "author": "J.R.R. Tolkien",
  "image": "https://example.com/covers/lotr.jpg",
  "title": "The Lord of the Rings",
  "subtitle": "The Fellowship of the Ring",
  "publisher": "Allen & Unwin",
  "year": "1954",
  "pages": 423,
  "isbn": "978-0-618-00222-1"
}

Status Codes

200
OK
Book retrieved successfully.
401
Unauthorized
Missing or invalid JWT token.
403
Forbidden
Valid token but insufficient permissions.
404
Not Found
Book with the specified ID does not exist.

Build docs developers (and LLMs) love