Library

The Library API allows you to get information about the currently open Eagle library.

Endpoints Overview

Method	Endpoint	Description
GET	/api/v2/library/info	Get library metadata
GET	/api/v2/library/history	Get library history list
POST	/api/v2/library/switch	Switch to a library
GET	/api/v2/library/icon	Get library icon

---

GET /api/v2/library/info

Returns metadata about the currently open Eagle library, including its name, path, and configuration.

Response

{
    "status": "success",
    "data": {
        "name": "My Design Library",
        "path": "D:\\Eagle Libraries\\My Design Library.library",
        "modificationTime": 1700000000000,
        "applicationVersion": "4.0",
        "folders": [],
        "smartFolders": [],
        "quickAccess": [],
        "tagGroups": []
    }
}

Example

await fetch("http://localhost:41595/api/v2/library/info").then(r => r.json());

---

GET /api/v2/library/history

Get the list of recently opened libraries. Returns paginated results.

Query Parameters

• offset integer (optional) — Pagination offset, default 0

• limit integer (optional) — Pagination limit, default 50, max 1000

Response

{
    "status": "success",
    "data": {
        "data": [
            {
                "name": "My Design Library",
                "path": "D:\\Eagle Libraries\\My Design Library.library"
            }
        ],
        "total": 3,
        "offset": 0,
        "limit": 50
    }
}

Examples

await fetch("http://localhost:41595/api/v2/library/history").then(r => r.json());

// With pagination
await fetch("http://localhost:41595/api/v2/library/history?offset=0&limit=10").then(r => r.json());

---

POST /api/v2/library/switch

Switch to a specified library.

Request Body

• libraryPath string (required) — Path to the library to switch to

Response

{
    "status": "success",
    "data": true
}

Example

await fetch("http://localhost:41595/api/v2/library/switch", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
        libraryPath: "D:\\Eagle Libraries\\My Design Library.library"
    })
}).then(r => r.json());

---

GET /api/v2/library/icon

Get the icon for a library.

Query Parameters

• libraryPath string (required) — Path to the library

Response

Returns the icon image data.

Example

await fetch("http://localhost:41595/api/v2/library/icon?libraryPath=D%3A%5CEagle%20Libraries%5CMy%20Design%20Library.library")
    .then(r => r.blob());

---

Library Properties

The library object contains the following properties:

Property	Type	Description
name	string	Library display name
path	string	Full path to the .library directory
modificationTime	integer	Last modification timestamp
applicationVersion	string	Eagle version that created this library
folders	Object[]	Top-level folder structure
smartFolders	Object[]	Smart folder configurations
quickAccess	Object[]	Quick access items
tagGroups	Object[]	Tag group definitions