Renew a patron's checked-out item via the Koha REST API
domain: koha-community.org · 4 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate with a staff account holding circulate permissions
Look up the target checkout_id via GET /api/v1/checkouts filtered by patron_id
POST to /api/v1/checkouts/{checkout_id}/renewal to renew the loan
Inspect the response for the new due_date or a renewal-denied reason
Known gotchas
A renewal can be refused for policy reasons (too many renewals, item on hold, fines over threshold) reported in the response body rather than as a plain HTTP error
Renewing for a patron whose fines exceed FineNoRenewals requires the AllowFineOverrideRenewing preference to be enabled
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?