Access Methods

Early Access Preview. The access methods API is currently in Alpha. We're actively developing it and seeking early feedback at [email protected]. Expect breaking changes as we refine the design.

The access_method Object

• Properties

• Events

• Endpoints

Represents an access method for an Access Grant. Access methods describe the modes of access, such as PIN codes, plastic cards, and mobile keys. For a mobile key, the access method also stores the URL for the associated Instant Key.

Card Access Method

A card access method resource.

{
  "access_method_id": "27d8ad77-55c2-4e20-b5b3-43555926f0e8",
  "created_at": "2025-06-14T16:54:17.946612Z",
  "display_name": "My Card",
  "is_card_encoding_required": true,
  "issued_at": "2025-06-14T16:54:17.946612Z",
  "mode": "card",
  "workspace_id": "661025d3-c1d2-403c-83a8-af153aaedfbc"
}

Mobile Key Access Method

A mobile key access method resource.

{
  "access_method_id": "27d8ad77-55c2-4e20-b5b3-43555926f0e8",
  "created_at": "2025-06-14T16:54:17.946612Z",
  "display_name": "My Mobile Key",
  "instant_key_url": "https://ik.seam.co/ABCXYZ",
  "is_card_encoding_required": false,
  "mode": "mobile_key",
  "workspace_id": "661025d3-c1d2-403c-83a8-af153aaedfbc"
}

PIN Code Access Method

A PIN code access method resource.

{
  "access_method_id": "27d8ad77-55c2-4e20-b5b3-43555926f0e8",
  "created_at": "2025-06-14T16:54:17.946612Z",
  "display_name": "My PIN Code",
  "is_card_encoding_required": false,
  "mode": "code",
  "workspace_id": "661025d3-c1d2-403c-83a8-af153aaedfbc"
}

---

Properties

access_method_id UUID

ID of the access method.

---

client_session_token String

Token of the client session associated with the access method.

---

code String

The actual PIN code for code access methods.

---

created_at Datetime

Date and time at which the access method was created.

---

customization_profile_id UUID

ID of the customization profile associated with the access method.

---

display_name String

Display name of the access method.

---

instant_key_url String

URL of the Instant Key for mobile key access methods.

---

is_encoding_required Boolean

Indicates whether encoding with an card encoder is required to issue or reissue the plastic card associated with the access method.

---

is_issued Boolean

Indicates whether the access method has been issued.

---

issued_at Datetime

Date and time at which the access method was issued.

---

mode Enum

Access method mode. Supported values: code, card, mobile_key.

Enum values

• code

• card

• mobile_key

---

workspace_id UUID

ID of the Seam workspace associated with the access method.

---

Events

access_method.issued

An access method was issued.

Properties

access_grant_ids List of UUIDs

IDs of the access grants associated with this access method.

access_grant_keys List of Strings

Keys of the access grants associated with this access method (if present).

access_method_id UUID

ID of the affected access method.

code String

The actual PIN code for code access methods (only present when mode is 'code').

created_at Datetime

Date and time at which the event was created.

event_id UUID

ID of the event.

event_type Enum

Value: access_method.issued

is_backup_code Boolean

Indicates whether the code is a backup code (only present when mode is 'code' and a backup code was used).

occurred_at Datetime

Date and time at which the event occurred.

workspace_id UUID

ID of the workspace associated with the event.

---

access_method.revoked

An access method was revoked.

Properties

access_grant_ids List of UUIDs

IDs of the access grants associated with this access method.

access_grant_keys List of Strings

Keys of the access grants associated with this access method (if present).

access_method_id UUID

ID of the affected access method.

created_at Datetime

Date and time at which the event was created.

event_id UUID

ID of the event.

event_type Enum

Value: access_method.revoked

occurred_at Datetime

Date and time at which the event occurred.

workspace_id UUID

ID of the workspace associated with the event.

---

access_method.card_encoding_required

An access method representing a physical card requires encoding.

Properties

access_grant_ids List of UUIDs

IDs of the access grants associated with this access method.

access_grant_keys List of Strings

Keys of the access grants associated with this access method (if present).

access_method_id UUID

ID of the affected access method.

created_at Datetime

Date and time at which the event was created.

event_id UUID

ID of the event.

event_type Enum

Value: access_method.card_encoding_required

occurred_at Datetime

Date and time at which the event occurred.

workspace_id UUID

ID of the workspace associated with the event.

---

access_method.deleted

An access method was deleted.

Properties

access_grant_ids List of UUIDs

IDs of the access grants associated with this access method.

access_grant_keys List of Strings

Keys of the access grants associated with this access method (if present).

access_method_id UUID

ID of the affected access method.

created_at Datetime

Date and time at which the event was created.

event_id UUID

ID of the event.

event_type Enum

Value: access_method.deleted

occurred_at Datetime

Date and time at which the event occurred.

workspace_id UUID

ID of the workspace associated with the event.

---

access_method.reissued

An access method was reissued due to an Access Grant update.

Properties

access_grant_ids List of UUIDs

IDs of the access grants associated with this access method.

access_grant_keys List of Strings

Keys of the access grants associated with this access method (if present).

access_method_id UUID

ID of the affected access method.

code String

The actual PIN code for code access methods (only present when mode is 'code').

created_at Datetime

Date and time at which the event was created.

event_id UUID

ID of the event.

event_type Enum

Value: access_method.reissued

is_backup_code Boolean

Indicates whether the code is a backup code (only present when mode is 'code' and a backup code was used).

occurred_at Datetime

Date and time at which the event occurred.

workspace_id UUID

ID of the workspace associated with the event.

---

Endpoints

/access_methods/delete

Deletes an access method.

/access_methods/encode

Encodes an existing access method onto a plastic card placed on the specified encoder.

/access_methods/get

Gets an access method.

/access_methods/get_related

Gets all related resources for one or more Access Methods.

/access_methods/list

Lists all access methods, usually filtered by Access Grant.