Skip to main content
POST
/
api
/
spaces
/
failedcheckins
{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}
A FailedCheckin records an unsuccessful check-in attempt by a coworker (see Checkin entity). Each record captures the coworker involved, the location where the attempt occurred, the reason for the failure, and contextual details such as the coworker’s teams and tariff at the time. Failed check-ins are read-only and generated automatically by the system when a check-in is rejected — for example, due to access restrictions, an inactive plan, or an unrecognised device. Use the Description field to inspect the specific failure reason. The Source field indicates how the check-in was initiated (e.g. manual, Wi-Fi, app) and matches the eCheckinSource enum used by the Checkin entity.

​
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 FailedCheckin-Create role.

​
Enums

ValueName
0None
1Manual
2DoorAccess
3NetworkActivity
4Tile
5Sensor

​
Request Body

​
Required Fields

​
BusinessId
integer
required
Business Id.
​
CheckinAttemptTime
string
required
Date and time when the check-in attempt occurred.

​
Optional Fields

​
CoworkerId
integer
Coworker Id.
​
MacAddresses
string
MAC addresses of the device used during the check-in attempt, if available.
​
TeamsAtTheTimeOfCheckin
string
Comma-separated list of teams the coworker belonged to at the time of the failed check-in.
​
TariffAtTheTimeOfCheckin
string
Name of the pricing plan (tariff) assigned to the coworker at the time of the failed check-in.
​
Description
string
Reason or explanation for why the check-in attempt failed.
​
CheckinAttemptTimeLocal
string
Checkin Attempt Time Local.

​
Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/spaces/failedcheckins" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "CheckinAttemptTime": "2025-01-15T10:30:00Z"
}'

​
Response

​
200

​
Status
integer
HTTP status code. 200 on success.
​
Message
string
A human-readable message confirming the creation.
​
Value
object
Contains the Id of the newly created record.
​
WasSuccessful
boolean
true if the failedcheckin was created successfully.
​
Errors
array
null on success.
Example Response
{
  "Status": 200,
  "Message": "FailedCheckin was successfully created.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

​
400

​
Message
string
A summary of the validation error(s), in the format PropertyName: error message.
​
Value
any
null on validation failure.
​
Errors
object[]
Array of validation errors.
​
WasSuccessful
boolean
false when the request fails validation.
Example Response
{
  "Message": "CheckinAttemptTime: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "CheckinAttemptTime"
    }
  ],
  "WasSuccessful": false
}