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

/access_codes/unmanaged/list

Authorizations

client_sessionpat_with_workspaceconsole_session_with_workspaceapi_key

Body

device_idstring · uuidrequired

user_identifier_keystring

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://connect.getseam.com/access_codes/unmanaged/list' \
  --header 'Authorization: Bearer Client Session Token' \
  --header 'Content-Type: application/json' \
  --data '{"device_id":"123e4567-e89b-12d3-a456-426614174000"}'

200

400

401

200

{
  "ok": true,
  "access_codes": [
    {
      "access_code_id": "123e4567-e89b-12d3-a456-426614174000",
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "code": "text",
      "created_at": "2025-02-21T14:36:54.810Z",
      "starts_at": "2025-02-21T14:36:54.810Z",
      "ends_at": "2025-02-21T14:36:54.810Z",
      "type": "time_bound",
      "is_managed": false,
      "status": "set",
      "errors": [
        {
          "message": "text",
          "is_access_code_error": true,
          "error_code": "smartthings_failed_to_set_access_code"
        }
      ],
      "warnings": [
        {
          "message": "text",
          "warning_code": "smartthings_failed_to_set_access_code"
        }
      ]
    }
  ]
}

OK

---

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
}