Workshops

The NC State University Library Workshops API provides information about workshops hosted at NC State University Libraries, including categories, user activities, locations, and registration details.

Endpoint

GET /api/workshops/everything.json

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

Query Parameters

Parameter	Type	Description
start_date	date	Return workshops starting on or after this date (e.g., "2025-03-07").
category	integer	Filter by workshop category ID (e.g., Makerspace) Full list (must be logged in)
user_activity	integer	Filter by user activity ID (e.g., 3D Printing) Full list (must be logged in)
lib	string	Filter by library location (hill | hunt | design | vetmed | natural-resources)
space	integer	Filter by event space name (e.g., Makerspace) Full list (must be logged in)

Response Format

The API returns an array of objects, where each object represents a workshop with details about location, time, and registration.

Example Response

[{
  "nid": "64715",
  "title": "Getting Started with Machine Sewing",
  "start_timestamp": 1741377600,
  "end_timestamp": 1741384800,
  "library_space": ["Makerspace"],
  "description": "
Learn how to use a sewing machine...
",
  "when": [{
    "start": "2025-03-07T20:00:00",
    "start_timestamp": 1741377600,
    "end": "2025-03-07T22:00:00",
    "end_timestamp": 1741384800
  }],
  "user_activity": ["Textiles"],
  "Workshop_category": ["Makerspace"],
  "building": ["D. H. Hill Jr. Library"],
  "date": "2025-03-07",
  "registration_url": "https://reporter.ncsu.edu/link/instanceview?courseID=LIB-MAKER-SEWING&deptName=LIB&instanceID=000005",
  "contact": {
    "name": "Aryn Baker",
    "email": "anbaker8@ncsu.edu"
  }
}]

Response Fields

Field	Type	Description
nid	string	Unique identifier for the workshop.
title	string	Title of the workshop.
start_timestamp	integer	Unix timestamp for workshop start time.
end_timestamp	integer	Unix timestamp for workshop end time.
library_space	array[string]	Library space where the workshop takes place.
description	string	HTML-formatted description of the workshop.
user_activity	array[string]	Associated user activities.
Workshop_category	array[string]	Workshop category.
building	array[string]	Library building where the workshop is hosted.
registration_url	string	URL for workshop registration.
contact	object	Contact details including name and email.

Usage Example

curl -X GET "https://www.lib.ncsu.edu/api/workshops/everything.json?start_date=2025-03-07&category=3825" -H "Accept: application/json"

Support

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