Skip to main content
GET
/
api
/
sys
/
automationtiles
{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}
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-List role.

Enums

ValueName
1None
2UnlockAct365Door
3CheckIn
4CheckOut
5BookingCheckIn
6EventCheckIn
7ResourceCleaned
8RequestUrl
9RedirectUrl
10UnlockDoorDeckDoor
11UnlockKisiDoor
12BookResource
13BookDesk
14ShowNewBookingForm
15SmartLock
16ExtendBookingBy
17ShowAcsModal
18UnlockPadWordDoor
19UnlockOPaxtonNet2Door
ValueName
1Low
2Medium
3High
4VeryHigh

Query Parameters

Pagination & Sorting

page
integer
default:"1"
The page number to retrieve.
size
integer
default:"25"
The number of records per page.
orderBy
string
The property name to sort results by (e.g. Name, CreatedOn).
dir
integer
Sort direction. 1 for ascending, -1 for descending.

Filters

AutomationTile_Business
integer
Filter by Business Id.
AutomationTile_Name
string
Filter by tile name used to identify it in the admin panel.
AutomationTile_TileNumber
string
Filter by unique tile identifier (GUID) auto-assigned on creation. Used to generate the QR code and NFC URL.
AutomationTile_Action
integer
Filter by action triggered when the tile is scanned: None, CheckIn, CheckOut, BookingCheckIn, EventCheckIn, ExtendBookingBy, RequestUrl, RedirectUrl, ResourceCleaned, BookResource, BookDesk, ShowNewBookingForm, UnlockAct365Door, UnlockDoorDeckDoor, UnlockKisiDoor, SmartLock, etc..
AutomationTile_ActionParameters
string
Filter by parameters for the selected action. Format depends on the action type — e.g. a resource ID, a URL, or a resource ID|duration pair.
AutomationTile_EnableGeofence
boolean
Filter by 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.
AutomationTile_CheckCustomerIn
boolean
Filter by whether to also check the customer into the space when they scan the tile, regardless of the primary action.
AutomationTile_Longitude
string
Filter by longitude of the tile’s installed location. Used for geofencing.
AutomationTile_Latitude
string
Filter by latitude of the tile’s installed location. Used for geofencing.
AutomationTile_GeofencePrecission
integer
Filter by geofence precision level: Low, Medium, High, or VeryHigh. Higher precision requires the user to be closer to the tile coordinates.
AutomationTile_MaxDistanceMeters
integer
Filter by custom maximum distance in meters from the tile’s coordinates. Overrides the precision preset when set.
AutomationTile_SuccessMessage
string
Filter by custom message shown to the user when the tile action completes successfully.
AutomationTile_ErrorMessage
string
Filter by custom error message shown to the user when the tile action fails.

Range Filters

from_AutomationTile_MaxDistanceMeters
integer
Filter by custom maximum distance in meters from the tile’s coordinates. Overrides the precision preset when set greater than or equal to this value.
to_AutomationTile_MaxDistanceMeters
integer
Filter by custom maximum distance in meters from the tile’s coordinates. Overrides the precision preset when set less than or equal to this value.
from_AutomationTile_CreatedOn
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
to_AutomationTile_CreatedOn
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
from_AutomationTile_UpdatedOn
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
to_AutomationTile_UpdatedOn
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

curl -X GET \
  "https://spaces.nexudus.com/api/sys/automationtiles?page=1&size=15&orderBy=Name&dir=1" \
  -H "Authorization: Bearer YOUR_TOKEN"

Filtering by Name

curl -X GET \
  "https://spaces.nexudus.com/api/sys/automationtiles?AutomationTile_Name=example-value&orderBy=Name&dir=1" \
  -H "Authorization: Bearer YOUR_TOKEN"

Range filters

curl -X GET \
  "https://spaces.nexudus.com/api/sys/automationtiles?from_AutomationTile_UpdatedOn=2025-01-01T00:00&to_AutomationTile_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=-1" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Records
AutomationTile[]
The list of AutomationTile records matching the query. See the Get one AutomationTile endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each AutomationTile. The following fields are not included in the Records[] response: Action, GeofencePrecission.To get all fields, fetch the full record using the Get one AutomationTile endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
CurrentPage
integer
Current page number.
CurrentPageSize
integer
Number of records per page.
CurrentOrderField
string
The field used for sorting.
CurrentSortDirection
integer
The sort direction (1 = ascending, -1 = descending).
FirstItem
integer
Index of the first item on the current page.
LastItem
integer
Index of the last item on the current page.
TotalItems
integer
Total number of matching records across all pages.
TotalPages
integer
Total number of pages.
HasNextPage
boolean
Whether there is a next page of results.
HasPreviousPage
boolean
Whether there is a previous page of results.
Example Response
{
  "Records": [
    {
      "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
    }
  ],
  "CurrentPageSize": 15,
  "CurrentPage": 1,
  "CurrentOrderField": "Name",
  "CurrentSortDirection": 1,
  "FirstItem": 1,
  "HasNextPage": false,
  "HasPreviousPage": false,
  "LastItem": 1,
  "PageNumber": 1,
  "PageSize": 15,
  "TotalItems": 1,
  "TotalPages": 1
}