Devices
The NC State University Library Devices API provides a list of devices available for checkout or use at the Libraries.
Endpoint
GET /api/devices/everything.json
Base URL: https://www.lib.ncsu.edu/api/devices/everything.json
Query Parameters
| Parameter | Type | Description |
|---|---|---|
category | string | Filter results by device category (e.g., "Scientific Models"). |
lending_method | string | Filter by lending method (e.g., "walkup"). |
building | string | Filter by library building (e.g., "Hill"). |
manufacturer | string | Filter by manufacturer name (e.g., "sony"). |
Response Format
The API returns an array of objects, where each object represents a device available at the library.
Example Response
[{
"nid": "62568",
"title": "3B 1/2 Life-Size Complete Human Dual Sex Muscle Model, 33 part",
"device-name": "1/2 Life-Size Complete Human Dual Sex Muscle Model, 33 part",
"path": "/devices/12-life-size-complete-human-dual-sex-muscle-model-33-part",
"body": "The complete human anatomy in a convenient size...",
"photo": "https://www.lib.ncsu.edu/sites/default/files/...jpg",
"categories": ["Scientific Models", "Design Tools"],
"lending_method": ["walkup"],
"lending_period": ["2hr"],
"device_os": "",
"manufacturer": "3B",
"hardware_specs": "",
"replacement_cost": "",
"call_number": "",
"catkey": "",
"request_url": "",
"spaces": ["Ask Us", "Ask Us"],
"buildings": ["Hill Library", "Hunt Library"]
}]Response Fields
| Field | Type | Description |
|---|---|---|
| nid | string | Unique identifier for the device. |
| title | string | Full title of the device. |
| device-name | string | Name of the device. |
| path | string | Relative URL path to the device details. |
| body | string | HTML-formatted description of the device. |
| photo | string | URL to an image of the device. |
| categories | array[string] | Categories the device belongs to. |
| lending_method | array[string] | Methods available for borrowing. |
| lending_period | array[string] | Duration the device can be borrowed. |
| device_os | string | Operating system (if applicable). |
| manufacturer | string | Manufacturer of the device. |
| hardware_specs | string | Hardware specifications. |
| replacement_cost | string | Cost to replace the device. |
| call_number | string | Library catalog call number. |
| catkey | string | Unique catalog identifier. |
| request_url | string | URL for requesting the device. |
| spaces | array[string] | Library spaces where the device can be accessed. |
| buildings | array[string] | Library buildings where the device is available. |
Usage Example
curl -X GET "https://www.lib.ncsu.edu/api/devices/everything.json" -H "Accept: application/json"Notes
- Some fields may be empty if data is not available.
- The
bodyfield contains HTML formatting. - Devices are available across multiple library buildings.
Support
For questions or issues related to this API, email the Web Team.
Updated