Get one AutomationTile

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>'

import requests

url = "https://spaces.nexudus.com/api/sys/automationtiles/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/sys/automationtiles/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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:

Action	ActionParameters format
CheckIn / CheckOut / EventCheckIn	Not required
BookingCheckIn / ResourceCleaned / ShowNewBookingForm	Resource ID
BookResource	Resource ID `\|` default booking length in minutes (default 60)
BookDesk	Desk (floor plan item) ID `\|` default booking length in minutes (default 480)
ExtendBookingBy	Number of minutes to extend
RequestUrl	Target URL for the HTTP POST request
RedirectUrl	URL to redirect the user to
UnlockAct365Door / UnlockDoorDeckDoor / UnlockKisiDoor	Door ID from the access-control provider
SmartLock	Smartalock 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

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"

const response = await fetch(
  'https://spaces.nexudus.com/api/sys/automationtiles/87654321',
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const record = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/sys/automationtiles/87654321',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

record = response.json()

Response

200

integer

ID of the business linked to this record.

string

Tile name used to identify it in the admin panel.

string

Unique tile identifier (GUID) auto-assigned on creation. Used to generate the QR code and NFC URL.

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.

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.

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.

boolean

Whether to also check the customer into the space when they scan the tile, regardless of the primary action.

string

Longitude of the tile’s installed location. Used for geofencing.

string

Latitude of the tile’s installed location. Used for geofencing.

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.

integer

Custom maximum distance in meters from the tile’s coordinates. Overrides the precision preset when set.

string

Custom message shown to the user when the tile action completes successfully.

string

Custom error message shown to the user when the tile action fails.

integer[]

List of resources linked to this record.

integer[]

List of tariffs linked to this record.

integer[]

List of time passes linked to this record.

integer[]

List of floor plan desks linked to this record.

integer

Unique record identifier.

string

UUID of the record.

string

Date and time the record was created (ISO 8601).

string

Date and time the record was last updated (ISO 8601).

string

Email of the user who last updated this record.

boolean

Whether the record was recently created.

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
}

Get multiple AutomationTilesRetrieve multiple AutomationTile records by their Ids in a single request.

Get one AutomationTile

curl --request GET \
  --url https://spaces.nexudus.com/api/sys/automationtiles/{id} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/sys/automationtiles/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/sys/automationtiles/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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>"
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Path Parameters

Code Examples

Response

200

​Authentication

​Path Parameters

​Code Examples

​Response

​200

Authentication

Path Parameters

Code Examples

Response

200