{"openapi":"3.1.0","info":{"title":"Bibli Developer API","version":"1.0.0","description":"Read-only access to Bibli catalog data including works, authors, series, and title records."},"servers":[{"url":"https:\/\/bibli.com.au\/api\/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token"}},"schemas":{"Author":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"}}},"Series":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"position":{"type":"integer","nullable":true}}},"Title":{"type":"object","properties":{"id":{"type":"integer"},"isbn13":{"type":"string","nullable":true},"format":{"type":"string","nullable":true},"publisher":{"type":"string","nullable":true},"imprint":{"type":"string","nullable":true},"publication_date":{"type":"string","format":"date","nullable":true},"previous_publication_date":{"type":"string","format":"date","nullable":true},"au_rrp":{"type":"number","nullable":true},"availability_code":{"type":"string","nullable":true},"cover_url":{"type":"string","nullable":true},"is_hidden":{"type":"boolean"}}},"Work":{"type":"object","properties":{"title":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string","nullable":true},"publication_year":{"type":"integer","nullable":true},"series":{"$ref":"#\/components\/schemas\/Series"},"authors":{"type":"array","items":{"$ref":"#\/components\/schemas\/Author"}},"titles":{"type":"array","items":{"$ref":"#\/components\/schemas\/Title"}}}}}},"security":[{"bearerAuth":[]}],"paths":{"\/works":{"get":{"summary":"List works","description":"Requires `catalog:read` or `works:read`.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"author","in":"query","schema":{"type":"string"}},{"name":"series","in":"query","schema":{"type":"string"}},{"name":"upcoming","in":"query","schema":{"type":"boolean"}},{"name":"per_page","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Paginated work list"}}}},"\/works\/{slug}":{"get":{"summary":"Get a work by slug","description":"Requires `catalog:read` or `works:read`.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Single work"},"404":{"description":"Work not found"}}}},"\/authors":{"get":{"summary":"List authors","description":"Requires `catalog:read` or `authors:read`.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"per_page","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Paginated author list"}}}},"\/authors\/{slug}":{"get":{"summary":"Get an author by slug","description":"Requires `catalog:read` or `authors:read`.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Single author"},"404":{"description":"Author not found"}}}},"\/series":{"get":{"summary":"List series","description":"Requires `catalog:read` or `series:read`.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"per_page","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Paginated series list"}}}},"\/series\/{id}":{"get":{"summary":"Get a series by id","description":"Requires `catalog:read` or `series:read`.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Single series"},"404":{"description":"Series not found"}}}},"\/titles":{"get":{"summary":"List title records","description":"Requires `catalog:read` or `titles:read`.","parameters":[{"name":"isbn13","in":"query","schema":{"type":"string"}},{"name":"work","in":"query","schema":{"type":"string"}},{"name":"upcoming","in":"query","schema":{"type":"boolean"}},{"name":"per_page","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Paginated title list"}}}},"\/titles\/{id}":{"get":{"summary":"Get a title record by id","description":"Requires `catalog:read` or `titles:read`.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Single title"},"404":{"description":"Title not found"}}}}},"x-bibli":{"available_scopes":["catalog:read","works:read","authors:read","series:read","titles:read"]}}