# Ex Libris APIs API

> Ex Libris APIs API on Apizie: 10 endpoints (Retrieve Printouts, Act on Printouts, Retrieve a Printout, Printout Service, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ai:exlibrisgroup-tasklists/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:exlibrisgroup-tasklists`
- Category: Artificial Intelligence
- Status: byok
- Source: https://exlibrisgroup.com
- Page: https://apizie.tech/api/ai/exlibrisgroup-tasklists
- OpenAPI: https://apizie.tech/api/ai/exlibrisgroup-tasklists/openapi.json

For more information on how to use these APIs, including how to create an API key required for authentication, see [Alma REST APIs](https://developers.exlibrisgroup.com/alma/apis).

## Endpoints

### Retrieve Printouts
`GET https://apizie.tech/v1/ai:exlibrisgroup-tasklists/get-almaws-v1-task-lists-printouts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| letter | string | no | Printout Name. Optional. |
| status | string | no | Printout status. Optional. Valid values are: Printed, Pending, Canceled. |
| printer_id | string | no | Printout Printer |
| printout_id | string | no | A list of Printout IDs (for example: 123,456,778) from 1 to the limit of 100 Optional. Use of this option overrides all of the filtering… |
| limit | integer | no | Limits the number of results. Optional. Valid values are 0-100. Default value: 10. |
| offset | integer | no | Offset of the results returned. Optional. Default value: 0, which means that the first results will be returned. |

### Act on Printouts
`POST https://apizie.tech/v1/ai:exlibrisgroup-tasklists/post-almaws-v1-task-lists-printouts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| letter | string | no | Printout Name. Optional. |
| status | string | no | Printout status. Optional. Valid values are: Printed, Pending, Canceled. |
| printer_id | string | no | Printout Printer |
| printout_id | string | no | A list of Printout IDs (for example: 123,456,778) from 1 to the limit of 100 Optional. Use of this option overrides all of the filtering… |
| op | string | yes | The operation to perform on the printout. Currently, the options are: 'mark_as_printed','mark_as_canceled' |

### Retrieve a Printout
`GET https://apizie.tech/v1/ai:exlibrisgroup-tasklists/get-almaws-v1-task-lists-printouts-printout-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| printout_id | string | yes | The Printout ID |

### Printout Service
`POST https://apizie.tech/v1/ai:exlibrisgroup-tasklists/post-almaws-v1-task-lists-printouts-printout-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| printout_id | string | yes | The Printout ID |
| op | string | yes | The operation to perform on the printout. Currently, the options are 'mark_as_printed','mark_as_canceled' |

### Get Requested Resources
`GET https://apizie.tech/v1/ai:exlibrisgroup-tasklists/get-almaws-v1-task-lists-requested-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library | string | yes | The library of the given circulation desk or department where the resources are located. Mandatory. |
| circ_desk | string | yes | The circulation desk where the action is being performed. Mandatory. |
| location | string | no | The location code. Optional. |
| order_by | string | no | The order in which to retrieve the results: location/call_number (default). |
| direction | string | no | The order direction in which to retrieve the results. Optional. |
| pickup_inst | string | no | The pickup institution. Optional. |
| reported | string | no | Show reported results: Y/N. Optional. |
| printed | string | no | Show printed results: Y/N. Optional. |
| limit | integer | no | Limits the number of results. Optional. Valid values are 0-100. Default value: 10. |
| offset | integer | no | Offset of the results returned. Optional. Default value: 0, which means that the first results will be returned. |

### Act on Requested Resources
`POST https://apizie.tech/v1/ai:exlibrisgroup-tasklists/post-almaws-v1-task-lists-requested-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library | string | no | The library of the given circulation desk or department where the resources are located. Mandatory. |
| circ_desk | string | no | The circulation desk where the action is being performed. Mandatory. |
| op | string | no | Operation to be preformed on the list of given requests. Currently the only supported action is 'mark_reported'. Mandatory. |
| location | string | no | The location code. Optional. |
| pickup_inst | string | no | The pickup institution. Optional. |
| reported | string | no | Show reported results: Y/N. Optional. |
| printed | string | no | Show printed results: Y/N. Optional. |

### Get Lending Requests
`GET https://apizie.tech/v1/ai:exlibrisgroup-tasklists/get-almaws-v1-task-lists-rs-lending-requests` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library | string | no | The resource sharing library for which lending requests should be retrieved. Mandatory. List of possible libraries can be retrieved using… |
| status | string | no | The status of lending requests to retrieve. Optional. List of possible statuses can be retrieved using the [GET… |
| printed | string | no | The 'printed' value of lending requests to retrieve. Optional. Possible values: Y, N. |
| reported | string | no | The 'reported' value of lending requests to retrieve. Optional. Possible values: Y, N. |
| partner | string | no | The partner value. Only lending requests from this partner should be retrieved. Optional. List of possible partners can be retrieved using… |
| requested_format | string | no | Requested format of the resource. Optional. List of possible formats can be retrieved using the [GET… |
| supplied_format | string | no | Supplied Format of the resource. Optional. List of possible formats can be retrieved using the [GET… |

### Act on Lending Requests
`POST https://apizie.tech/v1/ai:exlibrisgroup-tasklists/post-almaws-v1-task-lists-rs-lending-requests` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| library | string | no | The resource sharing library from which lending requests should be retrieved. Mandatory. List of possible libraries can be retrieved using… |
| op | string | no | Operation to be preformed on the list of given requests. Currently the only supported action is 'mark_reported'. Mandatory. |
| status | string | no | The status of lending requests to retrieve. Optional. List of possible statuses can be retrieved using the [GET… |
| printed | string | no | The 'printed' value of lending requests to retrieve. Optional. Possible values: Y, N. |
| reported | string | no | The 'reported' value of lending requests to retrieve. Optional. Possible values: Y, N. |
| partner | string | no | The partner value. Only lending requests from this partner should be. Optional. List of possible partners can be retrieved using the [GET… |
| requested_format | string | no | Requested format of the resource. Optional. List of possible formats can be retrieved using the [GET… |
| supplied_format | string | no | Supplied Format of the resource. Optional. List of possible formats can be retrieved using the [GET… |

### GET Task-lists Test API
`GET https://apizie.tech/v1/ai:exlibrisgroup-tasklists/get-almaws-v1-task-lists-test` (byok)

### POST Task-lists Test API
`POST https://apizie.tech/v1/ai:exlibrisgroup-tasklists/post-almaws-v1-task-lists-test` (byok)

## Example
```
curl "https://apizie.tech/v1/ai:exlibrisgroup-tasklists/get-almaws-v1-task-lists-printouts" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Ex Libris APIs API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ai:exlibrisgroup-tasklists/get-almaws-v1-task-lists-printouts with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Ex Libris APIs API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Ex Libris APIs itself also needs your own key from exlibrisgroup.com.

### Can AI agents use the Ex Libris APIs API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ai:exlibrisgroup-tasklists.

### What is the status of the Ex Libris APIs API?
Needs your own provider key (bring your own key)