Skip to main content
GET
List books

Authorizations

Authorization
string
header
required

Sign in as a person: Planner shows them what the agent asks for (planner:read, planner:propose) and they agree. The agent then sees what they can see. Discovery: /.well-known/oauth-protected-resource.

Scopes

planner:read

Read the festival records you can see in Planner.

Query Parameters

edition
integer

Read another edition by its year, e.g. 2027. Default: the current edition.

edition_id
string<uuid>

Read another edition by its id.

include
string

Add related records, comma-separated: authors (Authors); publicists (Publicists).

page
integer
default:1
Required range: x >= 1
per_page
integer
default:50
Required range: 1 <= x <= 200
q
string

Search title, isbn_13 (part of the value, any case).

updated_since
string<date-time>

Only records changed at or after this time: for keeping a copy in sync.

author_id
string<uuid>

Books with this main author.

isbn_13
string

Exact ISBN-13.

Response

A page of books.

data
object[]
meta
object