> ## 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 AccessToken

> Retrieve a single AccessToken record by its Id.

> **WiFi Access Tokens** provide unique network access codes for customers and visitors. They work alongside the Mikrotik, IronWifi, and Layer8 integrations. Access tokens can be shared with customers and visitors as part of visitor and booking confirmation emails. Each token includes a number of minutes of WiFi access and, optionally, an expiration date and user limit.

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

## Path Parameters

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

## Code Examples

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

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://spaces.nexudus.com/api/spaces/accesstokens/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/accesstokens/87654321',
      headers={
          'Authorization': 'Bearer YOUR_TOKEN'
      }
  )

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

## Response

### 200

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

<ResponseField name="AccessCode" type="string">
  Unique network access code used to connect to WiFi.
</ResponseField>

<ResponseField name="Description" type="string">
  Free-text description of this access token.
</ResponseField>

<ResponseField name="MinutesIncluded" type="integer">
  Total minutes of WiFi access included in this token.
</ResponseField>

<ResponseField name="ValidFrom" type="string">
  Start date from which this token can be used.
</ResponseField>

<ResponseField name="ValidTo" type="string">
  Expiration date after which this token is no longer valid.
</ResponseField>

<ResponseField name="UserLimit" type="integer">
  Maximum number of users that can use this token simultaneously.
</ResponseField>

<ResponseField name="MinutesLeft" type="integer">
  Remaining minutes of WiFi access available on this token.
</ResponseField>

<ResponseField name="MacAddress" type="string">
  MAC address of the device associated with this token.
</ResponseField>

<ResponseField name="BookingGuid" type="string">
  Booking Guid.
</ResponseField>

<ResponseField name="VisitorGuid" type="string">
  Visitor Guid.
</ResponseField>

<ResponseField name="LastAccess" type="string">
  Date and time this token was last used to connect.
</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}
{
  "BusinessId": 0,
  "AccessCode": "",
  "Description": null,
  "MinutesIncluded": 0,
  "ValidFrom": null,
  "ValidTo": null,
  "UserLimit": null,
  "MinutesLeft": 0,
  "MacAddress": null,
  "BookingGuid": null,
  "VisitorGuid": null,
  "LastAccess": 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": "AccessToken Example",
  "LocalizationDetails": null,
  "CustomFields": null
}
```
