Nexus SoftSphereDocumentation

REST API for Nexus Hospitality

Every HTTP endpoint the application exposes, grouped by resource.

Calling the API

The API is served from the same address as the application, under /api. Requests carry the session cookie issued at sign-in, so a browser session and an API call are the same identity and obey the same permissions.

Every state changing request (POST, PUT, PATCH, DELETE) must also carry this application family's presence header, or it is refused with 403 bad request. That refusal reads like a permissions fault but is not one. Integration and APIs lists the header per family.

Endpoints

158 endpoints in 50 resource groups.

activity · availability · billing · butler · butlers · channels · companies · concierge · connect · custom-domain · dashboard · experience-bookings · experiences · folios · frontdesk · g · glitches · glogin · glogout · groups · guests · health · housekeeping · login · logout · me · messages · next-number · nightaudit · nxdocs · nxdocs-file · nxtz · perms · portfolio · pos · properties · rate-plans · reports · reservations · revenue · roles · room-types · rooms · search · service-requests · sso · transfers · username · users · work-orders

activity 1

MethodPathAccess
GET/api/activityadministrator

availability 1

MethodPathAccess
GET/api/availabilitysigned in

billing 2

MethodPathAccess
GET/api/billing/foliossigned in
GET/api/billing/opensigned in

butler 1

MethodPathAccess
GET/api/butlersigned in

butlers 1

MethodPathAccess
GET/api/butlerssigned in

channels 3

MethodPathAccess
GET/api/channelssigned in
POST/api/channelsadministrator
POST/api/channels/:id/syncsigned in

companies 2

MethodPathAccess
GET/api/companiessigned in
POST/api/companiessigned in

concierge 1

MethodPathAccess
GET/api/conciergesigned in

connect 25

MethodPathAccess
GET/api/connect/connectionssigned in
POST/api/connect/connectionssigned in
DELETE/api/connect/connections/:idsigned in
PUT/api/connect/connections/:idsigned in
POST/api/connect/connections/:id/callsigned in
POST/api/connect/connections/:id/testsigned in
GET/api/connect/hookssigned in
POST/api/connect/hookssigned in
DELETE/api/connect/hooks/:idsigned in
PUT/api/connect/hooks/:idsigned in
GET/api/connect/hooks/:id/eventssigned in
GET/api/connect/logsigned in
GET/api/connect/metasigned in
GET/api/connect/subssigned in
POST/api/connect/subssigned in
DELETE/api/connect/subs/:idsigned in
PUT/api/connect/subs/:idsigned in
POST/api/connect/subs/:id/testadministrator
GET/api/connect/tokenssigned in
POST/api/connect/tokenssigned in
DELETE/api/connect/tokens/:idsigned in
PUT/api/connect/tokens/:idsigned in
POST/connect/hook/:slugsigned in
GET/connect/mcpsigned in
POST/connect/mcpsigned in

custom-domain 3

MethodPathAccess
GET/api/custom-domainsigned in
PUT/api/custom-domainadministrator
POST/api/custom-domain/verifyadministrator

dashboard 1

MethodPathAccess
GET/api/dashboardsigned in

experience-bookings 3

MethodPathAccess
GET/api/experience-bookingssigned in
POST/api/experience-bookingssigned in
POST/api/experience-bookings/:id/statussigned in

experiences 3

MethodPathAccess
GET/api/experiencesadministrator
POST/api/experiencesadministrator
PUT/api/experiences/:idadministrator

folios 5

MethodPathAccess
GET/api/folios/:idsigned in
POST/api/folios/:id/chargesigned in
POST/api/folios/:id/gateway-paymentsigned in
POST/api/folios/:id/paymentsigned in
POST/api/folios/:id/void/:itemIdadministrator

frontdesk 1

MethodPathAccess
GET/api/frontdesksigned in

g 9

MethodPathAccess
POST/api/g/checkinsigned in
GET/api/g/experiencessigned in
POST/api/g/experiencessigned in
GET/api/g/keysigned in
GET/api/g/mesigned in
GET/api/g/messagessigned in
POST/api/g/messagessigned in
POST/api/g/paysigned in
POST/api/g/requestsigned in

glitches 3

MethodPathAccess
GET/api/glitchessigned in
POST/api/glitchessigned in
POST/api/glitches/:id/resolvesigned in

glogin 1

MethodPathAccess
POST/api/gloginsigned in

glogout 1

MethodPathAccess
POST/api/glogoutsigned in

groups 2

MethodPathAccess
GET/api/groupssigned in
POST/api/groupssigned in

guests 4

MethodPathAccess
GET/api/guestssigned in
POST/api/guestssigned in
GET/api/guests/:idsigned in
PUT/api/guests/:idsigned in

health 1

MethodPathAccess
GET/api/healthsigned in

housekeeping 3

MethodPathAccess
GET/api/housekeepingsigned in
POST/api/housekeeping/taskssigned in
POST/api/housekeeping/tasks/:id/donesigned in

login 2

MethodPathAccess
POST/api/loginpublic
POST/api/login/2fapublic

logout 1

MethodPathAccess
POST/api/logoutsigned in

me 4

MethodPathAccess
GET/api/mesigned in
POST/api/me/passwordsigned in
GET/api/me/profilesigned in
PUT/api/me/profilesigned in

messages 3

MethodPathAccess
GET/api/messagessigned in
GET/api/messages/:ridsigned in
POST/api/messages/:ridsigned in

next-number 1

MethodPathAccess
GET/api/next-numbersigned in

nightaudit 2

MethodPathAccess
GET/api/nightauditsigned in
POST/api/nightaudit/runadministrator

nxdocs 2

MethodPathAccess
GET/api/nxdocs/:kind/:refsigned in
POST/api/nxdocs/:kind/:refsigned in

nxdocs-file 2

MethodPathAccess
DELETE/api/nxdocs-file/:idsigned in
GET/api/nxdocs-file/:idsigned in

nxtz 3

MethodPathAccess
GET/api/nxtzsigned in
PUT/api/nxtzsigned in
POST/api/nxtz/devicesigned in

perms 2

MethodPathAccess
GET/api/perms/catalogsigned in
GET/api/perms/resolvedadministrator

portfolio 1

MethodPathAccess
GET/api/portfoliosigned in

pos 7

MethodPathAccess
GET/api/possigned in
POST/api/pos/checkssigned in
GET/api/pos/checks/:idsigned in
POST/api/pos/checks/:id/itemssigned in
POST/api/pos/checks/:id/settlesigned in
POST/api/pos/menuadministrator
POST/api/pos/outletsadministrator

properties 3

MethodPathAccess
GET/api/propertiessigned in
POST/api/propertiesadministrator
PUT/api/properties/:idadministrator

rate-plans 3

MethodPathAccess
GET/api/rate-plansadministrator
POST/api/rate-plansadministrator
PUT/api/rate-plans/:idadministrator

reports 1

MethodPathAccess
GET/api/reportssigned in

reservations 11

MethodPathAccess
GET/api/reservationssigned in
POST/api/reservationssigned in
GET/api/reservations/:idsigned in
PUT/api/reservations/:idsigned in
POST/api/reservations/:id/assignsigned in
POST/api/reservations/:id/butlersigned in
POST/api/reservations/:id/cancelsigned in
POST/api/reservations/:id/checkinsigned in
POST/api/reservations/:id/checkoutsigned in
POST/api/reservations/:id/extendsigned in
POST/api/reservations/:id/movesigned in

revenue 2

MethodPathAccess
GET/api/revenuesigned in
POST/api/revenue/adjustadministrator

roles 5

MethodPathAccess
GET/api/rolesadministrator
POST/api/rolesadministrator
DELETE/api/roles/:idadministrator
PUT/api/roles/:idadministrator
GET/api/roles/:id/usersadministrator

room-types 3

MethodPathAccess
GET/api/room-typessigned in
POST/api/room-typesadministrator
PUT/api/room-types/:idadministrator

rooms 4

MethodPathAccess
GET/api/roomssigned in
POST/api/roomsadministrator
PUT/api/rooms/:idsigned in
POST/api/rooms/:id/statussigned in
MethodPathAccess
GET/api/searchsigned in
GET/api/search/coveragesigned in

service-requests 4

MethodPathAccess
GET/api/service-requestssigned in
POST/api/service-requestssigned in
POST/api/service-requests/:id/assignsigned in
POST/api/service-requests/:id/statussigned in

sso 1

MethodPathAccess
POST/api/sso/accountssigned in

transfers 3

MethodPathAccess
GET/api/transferssigned in
POST/api/transferssigned in
POST/api/transfers/:id/statussigned in

username 1

MethodPathAccess
POST/api/username/forgotpublic

users 5

MethodPathAccess
GET/api/usersadministrator
POST/api/usersadministrator
PUT/api/users/:idadministrator
GET/api/users/:id/rolesadministrator
PUT/api/users/:id/rolesadministrator

work-orders 3

MethodPathAccess
GET/api/work-orderssigned in
POST/api/work-orderssigned in
POST/api/work-orders/:id/resolvesigned in