# OverDrive API: Check library availability

> Finds ebook and audiobook editions a public library owns on OverDrive, with copies, holds and estimated wait when unavailable.

Unofficial. Not affiliated with or endorsed by OverDrive.

- Page: https://fous.com/methods/overdrive.com/check-library-availability
- Method: `overdrive.com/check_library_availability`, version 1
- Website: overdrive.com
- Returns: editions with title, author, format, copies owned and available, holds, estimated wait weeks, cover and catalog link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `title` | string | yes | `"Lessons in Chemistry"` | Book title, for example Lessons in Chemistry. |
| `author` | string | no | `"Bonnie Garmus"` | Optional author name, for example Bonnie Garmus. |
| `format` | string | no |  | Choose any, ebook, or audiobook; for example audiobook. One of "any", "ebook", "audiobook". Default "any". |
| `library` | string | yes | `"New York Public Library"` | Public library name or city, for example New York Public Library or Seattle. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "title": "Lessons in Chemistry",
  "author": "Bonnie Garmus",
  "library": "New York Public Library"
}
```

Its output:

```json
{
  "editions": [
    {
      "title": "Lessons in Chemistry",
      "author": "Bonnie Garmus",
      "format": "ebook",
      "catalog_link": "https://nypl.overdrive.com/media/6384649",
      "copies_owned": 17,
      "available_now": false,
      "number_of_holds": 76,
      "cover_image_link": "https://img1.od-cdn.com/ImageType-400/0111-1/{66227E65-A2C4-42E1-883A-43B8272BBE13}IMG400.JPG",
      "copies_available_now": 0,
      "estimated_wait_weeks": 9.1
    },
    {
      "title": "Lessons in Chemistry",
      "author": "Bonnie Garmus",
      "format": "audiobook",
      "catalog_link": "https://nypl.overdrive.com/media/6397003",
      "copies_owned": 81,
      "available_now": false,
      "number_of_holds": 6,
      "cover_image_link": "https://img2.od-cdn.com/ImageType-400/1191-1/{5AC0CB3C-7696-490C-9FBE-9D2E53167A7F}IMG400.JPG",
      "copies_available_now": 0,
      "estimated_wait_weeks": 0.3
    }
  ],
  "library_name": "New York Public Library"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"overdrive.com/check_library_availability","input":{"title":"Lessons in Chemistry","author":"Bonnie Garmus","library":"New York Public Library"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Is Lessons in Chemistry by Bonnie Garmus available as an audiobook at the Seattle Public Library right now, and how long is the hold wait?
- Check if my local library has the ebook version of Tomorrow, and Tomorrow, and Tomorrow, and how many copies are free to borrow.
- Find any audiobook editions of Project Hail Mary at New York Public Library with current holds and estimated wait time.
- Does the Austin library on OverDrive own a digital copy of The Midnight Library by Matt Haig, and what's the queue like?
- Search overdrive.com for the audiobook of Circe by Madeline Miller at the Chicago Public Library, showing copies owned and holds.

## Input schema

```json
{
  "type": "object",
  "required": [
    "title",
    "library"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Book title, for example Lessons in Chemistry."
    },
    "author": {
      "type": "string",
      "description": "Optional author name, for example Bonnie Garmus."
    },
    "format": {
      "enum": [
        "any",
        "ebook",
        "audiobook"
      ],
      "type": "string",
      "default": "any",
      "description": "Choose any, ebook, or audiobook; for example audiobook."
    },
    "library": {
      "type": "string",
      "description": "Public library name or city, for example New York Public Library or Seattle."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "library_name",
    "editions"
  ],
  "properties": {
    "editions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "author",
          "format",
          "copies_owned",
          "copies_available_now",
          "number_of_holds",
          "estimated_wait_weeks",
          "available_now",
          "cover_image_link",
          "catalog_link"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "format": {
            "enum": [
              "ebook",
              "audiobook"
            ],
            "type": "string"
          },
          "catalog_link": {
            "type": "string"
          },
          "copies_owned": {
            "type": [
              "integer",
              "null"
            ]
          },
          "available_now": {
            "type": "boolean"
          },
          "number_of_holds": {
            "type": [
              "integer",
              "null"
            ]
          },
          "cover_image_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "copies_available_now": {
            "type": [
              "integer",
              "null"
            ]
          },
          "estimated_wait_weeks": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "description": "Matching editions in the public catalog."
    },
    "library_name": {
      "type": "string",
      "description": "Public library collection name."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Open Library API: Get book details](https://fous.com/methods/openlibrary.org/get-book.md): Gets a book's catalog details from Open Library by its title, with an optional author or ISBN to identify the right book. Reading availability reflects listed editions; details may be missing when the catalog has none.
- [Open Library API: Search books](https://fous.com/methods/openlibrary.org/search-books.md): Finds Open Library books by search words, optionally narrowed by author and subject, sorted by relevance or publication age. Returns work-level results; free_online means at least one edition is marked public or borrowable, not that a loan is available now.
- [Audible API: Get audiobook details](https://fous.com/methods/audible.com/get-audiobook.md): Looks up an audiobook in an Audible store by title (optionally narrowed by author) or by Audible book link, and returns its details, narrators, length, rating, visitor price, series, publisher summary and whether that store's Plus Catalog includes it.
- [Project Gutenberg API: Search free books](https://fous.com/methods/gutenberg.org/search-free-books.md): Finds free public-domain Project Gutenberg books by title, author or topic, with authors, languages, subjects, recent downloads, and reading and download links. Public-domain status is based on the United States.
- [Goodreads API: Get book](https://fous.com/methods/goodreads.com/get-book.md): Gets one Goodreads book's details, reader ratings and edition information. The book can be a title, an ISBN or a book link; a title uses the best search match.
- [Open Library API: List books by author](https://fous.com/methods/openlibrary.org/list-author-books.md): Finds an Open Library author by name, link or key and lists their works with first publication year, edition count, cover and an author profile.
- [Google API: Search Google Books](https://fous.com/methods/books.google.com/search-books.md): Searches Google Books by words, author, subject or ISBN, with language, free-ebook and newest-first options. Ratings counts are not shown by the public book feed; newest sorts the available matches by publication date.
- [loc.gov API: Search Library of Congress collections](https://fous.com/methods/loc.gov/search-collections.md): Searches Library of Congress digital collections by keywords, material format and date range, in Library search relevance order. Rights notes may be unavailable for some records.
