Events

The NC State University Library Events API provides a list of events hosted at NC State University Libraries, including details about categories, locations, instructors, and times.

Endpoint

GET /api/events/everything.json

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

Query Parameters

Parameter	Type	Description
category	string	Filter events by category (e.g., "Wellness") Full list (must be logged in)
series	string	Filter events by series name (e.g., "Amazing Alumni") Full list (must be logged in)
user_activity	string	Filter by associated user activity (e.g., "Analyzing Data") Full list (must be logged in)
lib	string	Filter by library building (e.g., "hill | hunt | design | vetmed | natural-resources")
space	string	Filter by event space (e.g., "iPearl Immersion Theater") Full list (must be logged in)
nid	number	Filter by node id (e.g., "76886")

Response Format

The API returns an array of objects, where each object represents an event hosted at the library.

Example Response

[{
  "node_title": "Engineering Connections",
  "title": "Engineering Connections",
  "body": "
Join us for group counseling as we work on maintaining well-being and managing stressors specific to Engineering...
",
  "nid": "64783",
  "library_space": ["The Landing"],
  "non_library_space": [],
  "photo": "https://www.lib.ncsu.edu/sites/default/files/...png",
  "thumbnail": "https://www.lib.ncsu.edu/sites/default/files/...png",
  "category": ["Pop-Up", "Wellness"],
  "series":["Wellness"],
  "user_activity": [],
  "building": ["James B. Hunt Jr. Library"],
  "contact": {"name": "Alex Valencia", "email": "aavalenc@ncsu.edu"},
  "when": [{
    "value": "2025-03-07T13:30:00",
    "start": "2025-03-07T13:30:00",
    "start_timestamp": 1741372200,
    "value2": "2025-03-07T15:00:00",
    "end": "2025-03-07T15:00:00",
    "end_timestamp": 1741377600
  }],
  "start_timestamp": 1741372200,
  "end_timestamp": 1741377600
}]

Response Fields

Field	Type	Description
node_title	string	Title of the event.
title	string	Event title (duplicate of node_title).
body	string	HTML-formatted description of the event.
nid	string	Unique identifier for the event.
library_space	array[string]	Library spaces where the event takes place.
non_library_space	array[string]	Non-library spaces where the event takes place.
photo	string	URL to a photo of the event.
thumbnail	string	URL to a thumbnail image.
category	array[string]	Categories associated with the event.
user_activity	array[string]	Associated user activities.
building	array[string]	Library buildings where the event is hosted.
contact	object	Contact details including name and email.
when	array[object]	Start and end times for the event.
start_timestamp	integer	Unix timestamp for the start time.
end_timestamp	integer	Unix timestamp for the end time.

Usage Example

curl -X GET "https://www.lib.ncsu.edu/api/events/everything.json?category=Wellness&lib=James B. Hunt Jr. Library" -H "Accept: application/json"

Support

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