library-rest

List every author.

GET/authors

Returns every author on record, ordered by id. This endpoint is not paginated.

Responses

200 The full list of authors.

application/json

FieldTypeRequiredDescription
dataarray of objectyes
biostringyesA short biography of the author.
bookIdsarray of stringyesIds of the books this author has written.
idstringyesUnique identifier assigned by the server, prefixed with au_.
namestringyesThe author's full name.
metaobjectyesResponse metadata attached to every successful response.
requestIdstringyesCorrelation id for this request, echoed from the X-Request-Id request header or generated if absent. Useful for tracing a request across logs.
totalintegerTotal number of matches before pagination was applied. Present only on paginated list responses (currently GET /books).

Errors

CodeMessageDescription
401The request is missing a valid Authorization: Bearer <token> header.
500An unexpected error occurred. The response never leaks internal error details.

Response example

{
  "data": [
    {
      "bio": "bio_224",
      "bookIds": [
        "bookIds_363"
      ],
      "id": "id_212",
      "name": "name_666"
    }
  ],
  "meta": {
    "requestId": "requestId_825",
    "total": 32
  }
}