Get an Unmanaged Access Code

• Request Parameters

• Response

Returns a specified unmanaged access code.

You must specify either access_code_id or both device_id and code.

JavaScript

Returns a specified unmanaged access code.

Code

await seam.accessCodes.unmanaged.get({
  access_code_id: "41b984ec-1b74-48cd-ba68-16660cd792b6",
});

Output

{
  "access_code_id": "41b984ec-1b74-48cd-ba68-16660cd792b6",
  "code": "1234",
  "created_at": "2025-06-16T16:54:17.946283Z",
  "device_id": "6047cb40-73e5-4517-85c2-2664c2e4eca1",
  "ends_at": "2025-06-23T16:54:17.946261Z",
  "errors": [],
  "is_managed": false,
  "name": "My Unmanaged Access Code",
  "starts_at": "2025-06-21T16:54:17.946261Z",
  "status": "set",
  "type": "time_bound",
  "warnings": []
}

cURL

Returns a specified unmanaged access code.

Code

curl --include --request POST "https://connect.getseam.com/access_codes/unmanaged/get" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "access_code_id": "41b984ec-1b74-48cd-ba68-16660cd792b6"
}
EOF

Output

{
  "access_code": {
    "access_code_id": "41b984ec-1b74-48cd-ba68-16660cd792b6",
    "code": "1234",
    "created_at": "2025-06-16T16:54:17.946283Z",
    "device_id": "6047cb40-73e5-4517-85c2-2664c2e4eca1",
    "ends_at": "2025-06-23T16:54:17.946261Z",
    "errors": [],
    "is_managed": false,
    "name": "My Unmanaged Access Code",
    "starts_at": "2025-06-21T16:54:17.946261Z",
    "status": "set",
    "type": "time_bound",
    "warnings": []
  }
}

Python

Returns a specified unmanaged access code.

Code

seam.access_codes.unmanaged.get(access_code_id="41b984ec-1b74-48cd-ba68-16660cd792b6")

Output

UnmanagedAccessCode(
    access_code_id="41b984ec-1b74-48cd-ba68-16660cd792b6",
    code="1234",
    created_at="2025-06-16T16:54:17.946283Z",
    device_id="6047cb40-73e5-4517-85c2-2664c2e4eca1",
    ends_at="2025-06-23T16:54:17.946261Z",
    errors=[],
    is_managed=false,
    name="My Unmanaged Access Code",
    starts_at="2025-06-21T16:54:17.946261Z",
    status="set",
    type="time_bound",
    warnings=[],
)

Ruby

Returns a specified unmanaged access code.

Code

seam.access_codes.unmanaged.get(access_code_id: "41b984ec-1b74-48cd-ba68-16660cd792b6")

Output

{
  "access_code_id" => "41b984ec-1b74-48cd-ba68-16660cd792b6",
  "code" => "1234",
  "created_at" => "2025-06-16T16:54:17.946283Z",
  "device_id" => "6047cb40-73e5-4517-85c2-2664c2e4eca1",
  "ends_at" => "2025-06-23T16:54:17.946261Z",
  "errors" => [],
  "is_managed" => false,
  "name" => "My Unmanaged Access Code",
  "starts_at" => "2025-06-21T16:54:17.946261Z",
  "status" => "set",
  "type" => "time_bound",
  "warnings" => [],
}

PHP

Returns a specified unmanaged access code.

Code

<?php
$seam->access_codes->unmanaged->get(
    access_code_id: "41b984ec-1b74-48cd-ba68-16660cd792b6"
);

Output

<?php
[
    "access_code_id" => "41b984ec-1b74-48cd-ba68-16660cd792b6",
    "code" => "1234",
    "created_at" => "2025-06-16T16:54:17.946283Z",
    "device_id" => "6047cb40-73e5-4517-85c2-2664c2e4eca1",
    "ends_at" => "2025-06-23T16:54:17.946261Z",
    "errors" => [],
    "is_managed" => false,
    "name" => "My Unmanaged Access Code",
    "starts_at" => "2025-06-21T16:54:17.946261Z",
    "status" => "set",
    "type" => "time_bound",
    "warnings" => [],
];

Seam CLI

Returns a specified unmanaged access code.

Code

seam access-codes unmanaged get --access_code_id "41b984ec-1b74-48cd-ba68-16660cd792b6"

Output

{
  "access_code_id": "41b984ec-1b74-48cd-ba68-16660cd792b6",
  "code": "1234",
  "created_at": "2025-06-16T16:54:17.946283Z",
  "device_id": "6047cb40-73e5-4517-85c2-2664c2e4eca1",
  "ends_at": "2025-06-23T16:54:17.946261Z",
  "errors": [],
  "is_managed": false,
  "name": "My Unmanaged Access Code",
  "starts_at": "2025-06-21T16:54:17.946261Z",
  "status": "set",
  "type": "time_bound",
  "warnings": []
}

Authentication Methods

• API key

• Client session token

• Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

access_code_id String

ID of the unmanaged access code that you want to get. You must specify either access_code_id or both device_id and code.

---

code String

Code of the unmanaged access code that you want to get. You must specify either access_code_id or both device_id and code.

---

device_id String

ID of the device containing the unmanaged access code that you want to get. You must specify either access_code_id or both device_id and code.

---

Response

unmanaged_access_code

JSON

{
  "access_code_id": "88fa1812-bef8-4108-9fb4-4855376c3edf",
  "code": "1234",
  "created_at": "2025-06-16T16:54:17.946283Z",
  "device_id": "b3439f17-7273-46f3-9e20-9a283d9cb5b4",
  "ends_at": "2025-06-23T16:54:17.946261Z",
  "errors": [],
  "is_managed": false,
  "name": "My Unmanaged Access Code",
  "starts_at": "2025-06-21T16:54:17.946261Z",
  "status": "set",
  "type": "time_bound",
  "warnings": []
}