Spaces

The NC State University Library Spaces API provides information about reservable and non-reservable spaces available at the NC State University Libraries, including details about location, features, and access.

Endpoint

GET /api/spaces/everything.json

Base URL: https://www.lib.ncsu.edu/api/spaces/everything.json

Query Parameters

Parameter	Type	Description
featured	boolean	Filter for featured spaces (true or false).
title	string	Filter by space title.
hero	boolean	Filter for hero spaces (true or false).
building	string	Filter by library building (e.g., "hill", "hunt", "design", "vml", "vetmed").
reservation	boolean	Filter by reservable spaces.
inside	boolean	Filter for indoor spaces.
sound_level	string	Filter by sound level (e.g., "quiet", "collaborative").
work	string	Filter by type of work supported in the space.
access	string	Filter by who can access the space (e.g., "students", "faculty").
help	boolean	Filter spaces that offer assistance.
lighting_type	string	Filter by type of lighting available.

Response Format

The API returns an array of objects, where each object represents a library space with details about its features and availability.

Example Response

[{
  "nid": "55240",
  "title": "Dataspace 4K 55\" QLED Monitor",
  "description": "
The Dataspace sports a large, high-performance Samsung QH55H monitor...
",
  "building": ["Dataspace"],
  "access": ["Students", "Graduate Students", "Faculty", "Staff"],
  "popup-description": "
Use to view your data visualizations and other documents in high resolution...
",
  "days_in_advance": "7 days",
  "reservable_by": ["Students", "Graduate Students", "Faculty", "Staff"],
  "request_url": null
}]

Response Fields

Field	Type	Description
nid	string	Unique identifier for the space.
title	string	Name of the space.
description	string	HTML-formatted description of the space.
building	array[string]	Library building where the space is located.
access	array[string]	Who can access the space (e.g., students, faculty).
popup-description	string	Brief summary of the space’s purpose and features.
days_in_advance	string	Number of days in advance the space can be reserved.
reservable_by	array[string]	Groups allowed to reserve the space.
request_url	string	URL for space reservations (if applicable).

Usage Example

curl -X GET "https://www.lib.ncsu.edu/api/spaces/everything.json?building=hunt&reservation=true" -H "Accept: application/json"

Support

For questions or issues related to this API, visit the Web Team.