List Unmanaged Access Codes

Get all unmanaged access codes

Returns a list of all unmanaged access codes for a device.

The guide to migrating existing access codes provides an overview of the difference between managed and unmanaged access codes.

Not all providers support unmanaged access codes. The following providers do not support unmanaged access codes:

Kwikset

/access_codes/unmanaged/list

post

Returns a list of all unmanaged access codes.

Authorizations

client_sessionclient_session_with_customerpat_with_workspaceconsole_session_with_workspaceapi_key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

device_idstring · uuidRequired

ID of the device for which you want to list unmanaged access codes.

user_identifier_keystringOptional

Your user ID for the user by which to filter unmanaged access codes.

limitnumber · floatOptional

Numerical limit on the number of unmanaged access codes to return.

Default: 300000

searchstring · min: 1Optional

String for which to search. Filters returned access codes to include all records that satisfy a partial match using name, code or access_code_id.

page_cursorstring · nullableOptional

Identifies the specific page of results to return, obtained from the previous page's next_page_cursor.

Responses

200

OK

application/json

okbooleanRequired

400

Bad Request

401

Unauthorized

post

/access_codes/unmanaged/list

HTTPcURLJavaScriptPython

POST /access_codes/unmanaged/list HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "device_id": "123e4567-e89b-12d3-a456-426614174000",
  "user_identifier_key": "text",
  "limit": 300000,
  "search": "text",
  "page_cursor": "text"
}

{
  "access_codes": [
    {
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "time_bound",
      "access_code_id": "123e4567-e89b-12d3-a456-426614174000",
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "code": "text",
      "created_at": "2026-02-22T07:40:33.912Z",
      "errors": [
        {
          "message": "text",
          "is_access_code_error": true,
          "created_at": "2026-02-22T07:40:33.912Z",
          "error_code": "smartthings_failed_to_set_access_code"
        }
      ],
      "warnings": [
        {
          "message": "text",
          "created_at": "2026-02-22T07:40:33.912Z",
          "warning_code": "smartthings_failed_to_set_access_code"
        }
      ],
      "is_managed": false,
      "starts_at": "2026-02-22T07:40:33.912Z",
      "ends_at": "2026-02-22T07:40:33.912Z",
      "status": "set",
      "dormakaba_oracode_metadata": {
        "ext_stay_id": 1,
        "ext_user_level_id": "text",
        "ext_user_level_name": "text",
        "ext_site_name": "text",
        "is_cancellable": true,
        "is_extendable": true,
        "is_early_checkin_able": true
      }
    }
  ],
  "pagination": {
    "next_page_cursor": "text",
    "has_next_page": true,
    "next_page_url": "https://example.com"
  },
  "ok": true
}

---

Request

Filter the list of returned unmanaged access codes by device ID. You can also filter by user identifier key.

Request Body Parameters

Parameter	Type	Description
device_id	String (UUID) Required	ID of the devices for which to retrieve unmanaged access codes.
user_identifier_key	String Optional	Your own internal user ID for the user by which to filter unmanaged access codes.

Sample Request

Python

seam.access_codes.unmanaged.list(
  device_id="11111111-1111-1111-1111-444444444444"
)

# [AccessCode(
#   access_code_id='26d6138c-6524-4f3c-ac96-43cc3bea0a8d', 
#   type='ongoing', 
#   code='1988', 
#   name='Code 1', 
#   status='set'
#   )
#  ]

cURL (bash)

JavaScript

PHP

Ruby

---

Response

Returns an access_codes array, in which each returned access code (access_code) contains the set of applicable access code properties. For details, see Access Codes.

Sample Response

JSON

{
  "access_codes": [
    {
      "code": "1988",
      "name": "Code 1",
      "status": "set",
      "created_at": "2022-08-26T12:50:17.858Z",
      "access_code_id": "26d6138c-6524-4f3c-ac96-43cc3bea0a8d"
    },
    ...
  ],
  "ok": true
}