Skip to main content

The access_method Object

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.

Properties

String (UUID)
required
ID of the access method.
String
Token of the client session associated with the access method.
String or null
The actual PIN code for code access methods.
String (ISO 8601)
required
Date and time at which the access method was created.
String (UUID)
ID of the customization profile associated with the access method.
String
required
Display name of the access method.
String
required
Human-readable sentence describing where the access method sits in its relationship with the device or access system, for example Awaiting encoding. For display only. The wording is not stable and is not an enumeration — it may change at any time, so never compare against or branch on it. To make decisions, read is_issued, errors, and pending_mutations.
Array of Objects
required
Errors associated with the access method.
String
URL of the Instant Key for mobile key access methods.
Boolean
Indicates whether an existing card credential must be assigned to this access method before it can be issued. Only applies to card-mode access methods on systems that support credential assignment.
Boolean
Indicates whether encoding with an card encoder is required to issue or reissue the plastic card associated with the access method.
Boolean
required
Indicates whether the access method has been issued.
Boolean
Indicates whether the access method is ready for card assignment. This is true when the access method is in card mode, has not yet been issued, and the system supports credential assignment.
Boolean
Indicates whether the access method is ready to be encoded. This is true when the card has not yet been issued and the access system has received all the access the card needs. While it is false, pending_mutations contains waiting_for_access_on_acs_system.
String (ISO 8601) or null
required
Date and time at which the access method was issued.
Enum (String)
required
Access method mode. Supported values: code, card, mobile_key, cloud_key.
  • code
  • card
  • mobile_key
  • cloud_key
Array of Objects
required
Pending mutations for the access method. Indicates operations that are in progress.
Array of Objects
required
Warnings associated with the access method.
String (UUID)
required
ID of the Seam workspace associated with the access method.