Skip to main content
GET
/
api
/
sys
/
automationtiles
/
{id}
Get one AutomationTile
curl --request GET \
  --url https://spaces.nexudus.com/api/sys/automationtiles/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "BusinessId": 123,
  "Name": "<string>",
  "TileNumber": "<string>",
  "Action": 123,
  "ActionParameters": "<string>",
  "EnableGeofence": true,
  "CheckCustomerIn": true,
  "Longitude": "<string>",
  "Latitude": "<string>",
  "GeofencePrecission": 123,
  "MaxDistanceMeters": 123,
  "SuccessMessage": "<string>",
  "ErrorMessage": "<string>",
  "Resources": [
    123
  ],
  "Tariffs": [
    123
  ],
  "TimePasses": [
    123
  ],
  "FloorPlanDesks": [
    123
  ],
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}
An AutomationTile represents a physical NFC chip and QR code tile that triggers actions in a Nexudus-powered coworking space. Each tile is linked to a single action (e.g. check-in, booking, door unlock, HTTP request) that fires when a customer scans or taps the tile. The Action field determines what happens when the tile is scanned. Some actions require additional data in ActionParameters:
ActionActionParameters format
CheckIn / CheckOut / EventCheckInNot required
BookingCheckIn / ResourceCleaned / ShowNewBookingFormResource ID
BookResourceResource ID | default booking length in minutes (default 60)
BookDeskDesk (floor plan item) ID | default booking length in minutes (default 480)
ExtendBookingByNumber of minutes to extend
RequestUrlTarget URL for the HTTP POST request
RedirectUrlURL to redirect the user to
UnlockAct365Door / UnlockDoorDeckDoor / UnlockKisiDoorDoor ID from the access-control provider
SmartLockSmartalock locker bank ID
Tiles can optionally be geo-fenced to restrict scanning to a physical area around the tile’s installed location. Enable EnableGeofence, set Latitude/Longitude, and choose a GeofencePrecission level. MaxDistanceMeters overrides the precision preset with a custom radius. Set CheckCustomerIn to also check the customer into the space when they scan the tile, regardless of the tile’s primary action.

​
Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the AutomationTile-Read role.

​
Path Parameters

​
id
integer
required
The Id of the AutomationTile record to retrieve.

​
Code Examples

curl -X GET \
  "https://spaces.nexudus.com/api/sys/automationtiles/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

​
200

​
BusinessId
integer
ID of the business linked to this record.
​
Name
string
Tile name used to identify it in the admin panel.
​
TileNumber
string
Unique tile identifier (GUID) auto-assigned on creation. Used to generate the QR code and NFC URL.
​
Action
integer
Action triggered when the tile is scanned: None, CheckIn, CheckOut, BookingCheckIn, EventCheckIn, ExtendBookingBy, RequestUrl, RedirectUrl, ResourceCleaned, BookResource, BookDesk, ShowNewBookingForm, UnlockAct365Door, UnlockDoorDeckDoor, UnlockKisiDoor, SmartLock, etc.. See eAutomationTileAction enum values: 1 = None, 2 = UnlockAct365Door, 3 = CheckIn, 4 = CheckOut, 5 = BookingCheckIn, 6 = EventCheckIn, 7 = ResourceCleaned, 8 = RequestUrl, 9 = RedirectUrl, 10 = UnlockDoorDeckDoor, 11 = UnlockKisiDoor, 12 = BookResource, 13 = BookDesk, 14 = ShowNewBookingForm, 15 = SmartLock, 16 = ExtendBookingBy, 17 = ShowAcsModal, 18 = UnlockPadWordDoor, 19 = UnlockOPaxtonNet2Door.
​
ActionParameters
string
Parameters for the selected action. Format depends on the action type — e.g. a resource ID, a URL, or a resource ID|duration pair.
​
EnableGeofence
boolean
Whether to restrict the tile to a geographic area. When enabled, the tile only works if the user is within the configured radius of the tile’s coordinates.
​
CheckCustomerIn
boolean
Whether to also check the customer into the space when they scan the tile, regardless of the primary action.
​
Longitude
string
Longitude of the tile’s installed location. Used for geofencing.
​
Latitude
string
Latitude of the tile’s installed location. Used for geofencing.
​
GeofencePrecission
integer
Geofence precision level: Low, Medium, High, or VeryHigh. Higher precision requires the user to be closer to the tile coordinates. See eAutomationTileGeofencePrecission enum values: 1 = Low, 2 = Medium, 3 = High, 4 = VeryHigh.
​
MaxDistanceMeters
integer
Custom maximum distance in meters from the tile’s coordinates. Overrides the precision preset when set.
​
SuccessMessage
string
Custom message shown to the user when the tile action completes successfully.
​
ErrorMessage
string
Custom error message shown to the user when the tile action fails.
​
Resources
integer[]
List of resources linked to this record.
​
Tariffs
integer[]
List of tariffs linked to this record.
​
TimePasses
integer[]
List of time passes linked to this record.
​
FloorPlanDesks
integer[]
List of floor plan desks linked to this record.
​
Id
integer
Unique record identifier.
​
UniqueId
string
UUID of the record.
​
CreatedOn
string
Date and time the record was created (ISO 8601).
​
UpdatedOn
string
Date and time the record was last updated (ISO 8601).
​
UpdatedBy
string
Email of the user who last updated this record.
​
IsNew
boolean
Whether the record was recently created.
​
SystemId
string
External system identifier.
Example Response
{
  "BusinessId": 0,
  "Name": "",
  "TileNumber": null,
  "Action": 0,
  "ActionParameters": null,
  "EnableGeofence": false,
  "CheckCustomerIn": false,
  "Longitude": null,
  "Latitude": null,
  "GeofencePrecission": 0,
  "MaxDistanceMeters": null,
  "SuccessMessage": null,
  "ErrorMessage": null,
  "Resources": [],
  "Tariffs": [],
  "TimePasses": [],
  "FloorPlanDesks": [],
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "AutomationTile Example",
  "LocalizationDetails": null,
  "CustomFields": null
}