> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one FailedCheckin

> Retrieve a single FailedCheckin record by its Id.

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

<Note>
  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-Read`** role.
</Note>

## Path Parameters

<ParamField path="id" type="integer" required>
  The Id of the FailedCheckin record to retrieve.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    "https://spaces.nexudus.com/api/spaces/failedcheckins/87654321" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://spaces.nexudus.com/api/spaces/failedcheckins/87654321',
    {
      headers: {
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    }
  );

  const record = await response.json();
  ```

  ```python Python theme={null}
  import requests

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

  record = response.json()
  ```
</CodeGroup>

## Response

### 200

<ResponseField name="CoworkerId" type="integer">
  Coworker Id.
</ResponseField>

<ResponseField name="CoworkerFullName" type="string">
  Full name of the coworker at the time of the failed check-in.
</ResponseField>

<ResponseField name="BusinessId" type="integer">
  Business Id.
</ResponseField>

<ResponseField name="BusinessName" type="string">
  Name of the location where the check-in was attempted.
</ResponseField>

<ResponseField name="CheckinAttemptTime" type="string">
  Date and time when the check-in attempt occurred.
</ResponseField>

<ResponseField name="Source" type="integer">
  Method used to initiate the check-in attempt (e.g. manual, Wi-Fi, app). See `eCheckinSource` enum values: `0` = None, `1` = Manual, `2` = DoorAccess, `3` = NetworkActivity, `4` = Tile, `5` = Sensor.
</ResponseField>

<ResponseField name="MacAddresses" type="string">
  MAC addresses of the device used during the check-in attempt, if available.
</ResponseField>

<ResponseField name="TeamsAtTheTimeOfCheckin" type="string">
  Comma-separated list of teams the coworker belonged to at the time of the failed check-in.
</ResponseField>

<ResponseField name="TariffAtTheTimeOfCheckin" type="string">
  Name of the pricing plan (tariff) assigned to the coworker at the time of the failed check-in.
</ResponseField>

<ResponseField name="Description" type="string">
  Reason or explanation for why the check-in attempt failed.
</ResponseField>

<ResponseField name="CheckinAttemptTimeLocal" type="string">
  Checkin Attempt Time Local.
</ResponseField>

<ResponseField name="Id" type="integer">
  Unique record identifier.
</ResponseField>

<ResponseField name="UniqueId" type="string">
  UUID of the record.
</ResponseField>

<ResponseField name="CreatedOn" type="string">
  Date and time the record was created (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedOn" type="string">
  Date and time the record was last updated (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedBy" type="string">
  Email of the user who last updated this record.
</ResponseField>

<ResponseField name="IsNew" type="boolean">
  Whether the record was recently created.
</ResponseField>

<ResponseField name="SystemId" type="string">
  External system identifier.
</ResponseField>

```json Example Response theme={null}
{
  "CoworkerId": null,
  "CoworkerFullName": null,
  "BusinessId": 0,
  "BusinessName": null,
  "CheckinAttemptTime": "2025-01-15T10:30:00Z",
  "Source": 0,
  "MacAddresses": null,
  "TeamsAtTheTimeOfCheckin": null,
  "TariffAtTheTimeOfCheckin": null,
  "Description": null,
  "CheckinAttemptTimeLocal": null,
  "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": "FailedCheckin Example",
  "LocalizationDetails": null,
  "CustomFields": null
}
```