Check availability by branch
check_availabilityFind live copy-level availability for a title by title ID: see which branches have it on the shelf now, call numbers, and due dates for checked-out copies.
Instructions
Live, copy-level availability for one title: which branches have it on the shelf right now, call numbers, and due dates for checked-out copies. Branches with a copy on the shelf are listed first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title_id": "<title_id>"
},
"name": "check_availability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of branches to return. | |
| branch | No | Only this branch (name or code). | |
| library | No | Library system id such as "tpl" (Toronto), "vpl" (Vancouver), "chipublib" (Chicago). Get it from find_library. A city or library name also works. | |
| title_id | Yes | A title_id from search_catalog, e.g. "S234C3970025". | |
| on_shelf_only | No | Only branches where a copy is on the shelf right now. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| format | Yes | ||
| source | Yes | Provenance of the data. | |
| library | Yes | ||
| summary | Yes | ||
| branches | Yes | ||
| title_id | Yes | ||
| truncated | Yes | True if more branches matched than `limit`. | |
| branches_holding | Yes | Branches that own at least one copy. | |
| branches_on_shelf | Yes | Branches with a copy on the shelf right now. |