FullDatasets
Datasets
Use cases Docs
Sign up
Docs

API reference

Get a work

GET /v1/works/{id}

Work record and synopsis.

Markdown Full spec OpenAPI

Abstract title. This is where description / description_source live. About 8.4M of 78.2M works have a synopsis in this release.

MCP: get_work { "id": "fds_wk_61363037333564616531" }

When to use

You have a work_id from a book object and want the work record (or to re-fetch the synopsis). Book / ISBN / search / match already join the parent description onto the edition — you usually do not need this call for product UI.

Request

curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
  https://api.fulldatasets.com/v1/works/fds_wk_61363037333564616531
Path Required Notes
id yes Work id (fds_wk_…)

Response `200`

{
  "id": "fds_wk_61363037333564616531",
  "title": "Project Hail Mary",
  "subtitle": null,
  "language": "eng",
  "subjects": [],
  "series": null,
  "description": "Ryland Grace is the sole survivor…",
  "description_source": "open_library.description",
  "release": "2026-09.2"
}
  • 301 — merged work; follow Location
  • 404 — unknown id

Cached 24h after auth.

See also