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_sessionpat_with_workspaceconsole_session_with_workspaceapi_key

Body

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.

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

HTTPcURLJavaScriptPython

POST /access_codes/unmanaged/list HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer Client Session Token
Content-Type: application/json
Accept: */*
Content-Length: 81

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

{
  "access_codes": [
    {
      "type": "time_bound",
      "access_code_id": "123e4567-e89b-12d3-a456-426614174000",
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "code": "text",
      "created_at": "2025-05-06T09:21:17.322Z",
      "errors": [
        {
          "message": "text",
          "is_access_code_error": true,
          "created_at": "2025-05-06T09:21:17.322Z",
          "error_code": "smartthings_failed_to_set_access_code"
        }
      ],
      "warnings": [
        {
          "message": "text",
          "created_at": "2025-05-06T09:21:17.322Z",
          "warning_code": "smartthings_failed_to_set_access_code"
        }
      ],
      "is_managed": false,
      "starts_at": "2025-05-06T09:21:17.322Z",
      "ends_at": "2025-05-06T09:21:17.322Z",
      "status": "set"
    }
  ],
  "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)

# Use GET or POST.
curl -X 'GET' \
  'https://connect.getseam.com/access_codes/unmanaged/list' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
    "device_id": "11111111-1111-1111-1111-444444444444"
  }'

JavaScript

await seam.accessCodes.unmanaged.list({
  device_id: "11111111-1111-1111-1111-444444444444"
});

/*
[
  {
    code: '1988',
    name: 'Code 1',
    status: 'set',
    created_at: '2022-08-26T12:50:17.858Z',
    access_code_id: '26d6138c-6524-4f3c-ac96-43cc3bea0a8d'
  }
]
*/

PHP

$seam->access_codes->unmanaged->list(
  device_id: '11111111-1111-1111-1111-444444444444',
);

Ruby

seam.access_codes.unmanaged.list(
  device_id: "123e4567-e89b-12d3-a456-426614174000"
)

# [<Seam::AccessCode:0x007cd58
#   code="669781"
#   name="My first code"
#   created_at="2022-07-06T23:26:42.223Z"
#   access_code_id="f19bc8cb-15be-43af-bb52-f1a417e0ff09">]

---

Response

Returns an access_codes array, in which each returned 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
}