Hours

The NC State University Library Hours API provides real-time and scheduled opening hours for various library locations and services.

Endpoint

GET /api/hours/everything.json

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

Query Parameters

Parameter	Type	Description
adverse_weather	boolean	Return hours altered due to adverse weather (e.g., true | false).
date	date	Start date for returned hours (e.g., 2025-03-07).
end_date	date	End date for returned hours (optional, e.g., 2025-12-31).
exam_hours	boolean	Return hours altered for exams (e.g., true | false).
exception	boolean	Return exception hours instead of regular hours (e.g., true | false).
library_short_name	string	Filter by library (e.g., design | hill | hunt | natural-resources | vetmed).
service_short_name	string	Filter by service (e.g., general | innovation-studio | hunt-ask-us | chat | creamery | makerspace | VR-Studio | common-grounds | hill-of-beans | special-collections).

Response Format

The API returns an array of objects, where each object represents the hours for a specific library location or service.

Example Response

[{
  "time": "2025-03-7 2:16pm",
  "date": "2025-03-7",
  "node_title": "D. H. Hill Jr. Library - General - Spring 2025 [FR]",
  "id": "64720",
  "hours": {
    "value": "2025-03-07 00:00:00",
    "value2": "2025-03-07 22:00:00",
    "rrule": "RRULE:FREQ=WEEKLY;BYDAY=FR;UNTIL=20250514T035959Z",
    "timezone": "America/New_York",
    "start_date": 1741323600,
    "end_date": 1741402800
  },
  "service": "22485",
  "twenty_four_hours": "0",
  "appointment_only": "0",
  "closed": "0",
  "midnight": "0",
  "exception": "0",
  "adverse_weather": "0",
  "exam_hours": "0",
  "library_id": "22493",
  "library_name": "D. H. Hill Jr. Library",
  "library_shortened_name": "Hill Library",
  "library_short_name": "hill",
  "service_id": "22485",
  "service_name": "General",
  "service_short_name": "general",
  "semester": "spring",
  "semester_id": "124",
  "status": "open",
  "display": "closes at 10pm",
  "realtime_note": "closes at 10pm"
}]

Response Fields

Field	Type	Description
time	string	Time of query response.
date	string	Date for the hours provided.
library_name	string	Full name of the library.
library_short_name	string	Shortened name of the library.
service_name	string	Name of the service.
service_short_name	string	Shortened name of the service.
status	string	Open or closed status.
display	string	Human-readable display of hours.

Usage Example

curl -X GET "https://www.lib.ncsu.edu/api/hours/everything.json?date=2025-03-07&library_short_name=hill" -H "Accept: application/json"

Support

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