curl --request GET \
--url https://api.nexspace365.com/api/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nexspace365.com/api/activity"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nexspace365.com/api/activity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nexspace365.com/api/activity",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nexspace365.com/api/activity"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nexspace365.com/api/activity")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nexspace365.com/api/activity")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"events": [
{
"id": "<string>",
"category": "shifts",
"kind": "<string>",
"title": "<string>",
"detail": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"facilityId": 123,
"facilityName": "<string>",
"actor": {
"id": 123,
"type": "user",
"name": "<string>"
},
"link": "<string>",
"entityType": "<string>",
"entityId": 123
}
],
"nextCursor": "<string>",
"window": "<string>",
"categories": [
"<string>"
],
"availableCategories": [
"<string>"
]
}{
"error": {
"message": "Invalid or revoked API key",
"code": "UNAUTHENTICATED",
"suggestion": "Send a valid `Authorization: Bearer <token>` (nex_live_/nex_pat_ key, JWT, or OAuth access token).",
"retryable": false
}
}{
"error": {
"message": "Insufficient API key scope",
"code": "INSUFFICIENT_SCOPE",
"suggestion": "Mint or rotate a key that includes the required scope, or grant a wildcard like `resource:*`.",
"retryable": false
}
}{
"error": {
"message": "Rate limit exceeded for this API key",
"code": "API_KEY_RATE_LIMITED",
"suggestion": "Wait until X-RateLimit-Reset before retrying, or batch operations.",
"retryable": true
}
}Get the organization activity feed
Tenant-scoped feed of what happened in the business — shift lifecycle transitions, timesheet submissions and approvals, worker onboarding and facility changes. Distinct from /api/notifications, which is the caller’s personal inbox. Defaults to the operations categories over the last 7 days. audit and agents are permission-gated filters (system.view_audit_logs / agents.manage); availableCategories reports which ones this caller may request. An API-key request is authorized on the KEY’s scopes alone, never the key owner’s role, and a facility-locked key is clamped to its facility.
Paginated with an opaque keyset cursor — pass a response’s nextCursor back as cursor. CAVEAT: two event kinds are keyed on a mutable timestamp because their tables record nothing better — timesheet.submitted uses timesheets.updated_at and facility.changed uses facilities.updated_at. If such a row is edited between two page requests its instant moves to now, above the cursor, and that page will not include it. The keyset can never DUPLICATE a row, and restarting without a cursor shows the edited row at the top. timesheet.submitted is likewise a snapshot of the pending set, not a log: the event is replaced by timesheet.approved once the sheet is approved.
Required API-key scope: analytics:read
curl --request GET \
--url https://api.nexspace365.com/api/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nexspace365.com/api/activity"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nexspace365.com/api/activity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nexspace365.com/api/activity",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nexspace365.com/api/activity"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nexspace365.com/api/activity")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nexspace365.com/api/activity")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"events": [
{
"id": "<string>",
"category": "shifts",
"kind": "<string>",
"title": "<string>",
"detail": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"facilityId": 123,
"facilityName": "<string>",
"actor": {
"id": 123,
"type": "user",
"name": "<string>"
},
"link": "<string>",
"entityType": "<string>",
"entityId": 123
}
],
"nextCursor": "<string>",
"window": "<string>",
"categories": [
"<string>"
],
"availableCategories": [
"<string>"
]
}{
"error": {
"message": "Invalid or revoked API key",
"code": "UNAUTHENTICATED",
"suggestion": "Send a valid `Authorization: Bearer <token>` (nex_live_/nex_pat_ key, JWT, or OAuth access token).",
"retryable": false
}
}{
"error": {
"message": "Insufficient API key scope",
"code": "INSUFFICIENT_SCOPE",
"suggestion": "Mint or rotate a key that includes the required scope, or grant a wildcard like `resource:*`.",
"retryable": false
}
}{
"error": {
"message": "Rate limit exceeded for this API key",
"code": "API_KEY_RATE_LIMITED",
"suggestion": "Wait until X-RateLimit-Reset before retrying, or batch operations.",
"retryable": true
}
}Authorizations
JWT token authentication
Headers
Pin the request to a dated API version (e.g. 2026-05-10). Applied by app-level middleware to every /api route (server/routes/index.ts → apiVersionMiddleware), which echoes the resolved value back in the NexSpace-Version response header. Omit to get the latest version. Discover the catalog at GET /.well-known/api-versions.
^\d{4}-\d{2}-\d{2}$Query Parameters
Repeatable, or a comma-separated list. Omit for the operations default (shifts, timesheets, people, facilities). A gated category the caller may not see is dropped; asking ONLY for gated categories returns 403.
shifts, timesheets, people, facilities, audit, agents Lookback window.
24h, 7d, 30d, 90d Opaque keyset cursor from a previous response's nextCursor.
1 <= x <= 100Narrow to one actor. Must be sent with actorType.
Id space of actorId. users.id and facility_users.id are independent sequences that collide numerically, so an id alone is ambiguous and is ignored.
user, facility_user 
