> ## Documentation Index
> Fetch the complete documentation index at: https://www.seam.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an Unmanaged Access Method

> Gets an unmanaged access method (where is_managed = false).



## OpenAPI

````yaml /openapi.json get /access_methods/unmanaged/get
openapi: 3.0.0
info:
  description: >-
    Programmable API to control locks, thermostats, noise sensors, cameras,
    access control systems, and other IoT devices.


    Prefer the official Seam SDKs over hand-written HTTP calls: they handle

    authentication, request serialization, pagination, and error handling for

    you. The official SDKs are listed in this document under

    `info.x-seam-sdks`.


    If you call the HTTP API directly, your query parameters must be

    serialized compatibly with the Seam API. There is no universal convention

    for serializing arrays, booleans, or nested objects in a query string, so

    use @seamapi/url-search-params-serializer, the language specific serializer
    module provided by each Seam SDK, or follow its specification:

    https://github.com/seamapi/url-search-params-serializer
  title: Seam Connect
  version: 1.0.0
  x-seam-query-serializer:
    description: >-
      Reference implementation and specification for query parameter
      serialization compatible with the Seam API.
    url: https://github.com/seamapi/url-search-params-serializer
  x-seam-sdks:
    - language: javascript
      url: https://github.com/seamapi/javascript
    - language: python
      url: https://github.com/seamapi/python
    - language: ruby
      url: https://github.com/seamapi/ruby
    - language: php
      url: https://github.com/seamapi/php
    - language: csharp
      url: https://github.com/seamapi/csharp
servers:
  - url: https://connect.getseam.com
security: []
tags:
  - description: access_codes
    name: /access_codes
  - description: acs
    name: /acs
  - description: action_attempts
    name: /action_attempts
  - description: client_sessions
    name: /client_sessions
  - description: connected_accounts
    name: /connected_accounts
  - description: connect_webviews
    name: /connect_webviews
  - description: devices
    name: /devices
  - description: events
    name: /events
  - description: health
    name: /health
  - description: locks
    name: /locks
  - description: networks
    name: /networks
  - description: noise_sensors
    name: /noise_sensors
  - description: phones
    name: /phones
  - description: thermostats
    name: /thermostats
  - description: user_identities
    name: /user_identities
  - description: webhooks
    name: /webhooks
  - description: workspaces
    name: /workspaces
paths:
  /access_methods/unmanaged/get:
    get:
      tags: []
      summary: Get an Unmanaged Access Method
      description: Gets an unmanaged access method (where is_managed = false).
      operationId: accessMethodsUnmanagedGetGet
      parameters:
        - in: query
          name: access_method_id
          required: true
          schema:
            description: ID of unmanaged access method to get.
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  access_method:
                    $ref: '#/components/schemas/unmanaged_access_method'
                required:
                  - access_method
                type: object
          description: OK
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      security:
        - pat_with_workspace: []
        - console_session_with_workspace: []
        - api_key: []
        - support_read_only_token: []
components:
  schemas:
    unmanaged_access_method:
      description: >-
        Represents an unmanaged access method. Unmanaged access methods do not
        have client sessions, instant keys, customization profiles, or keys.
      properties:
        access_method_id:
          description: ID of the access method.
          format: uuid
          type: string
        code:
          description: The actual PIN code for code access methods.
          nullable: true
          type: string
        created_at:
          description: Date and time at which the access method was created.
          format: date-time
          type: string
        display_name:
          description: Display name of the access method.
          type: string
        display_status:
          description: >-
            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`.
          type: string
        errors:
          description: >-
            Errors associated with the [access
            method](/use-cases/granting-access/creating-an-access-grant).
          items:
            description: >-
              Error associated with the [access
              method](/use-cases/granting-access/creating-an-access-grant).
            discriminator:
              propertyName: error_code
            oneOf:
              - description: >-
                  Indicates that Seam was unable to issue this [access
                  method](/use-cases/granting-access/creating-an-access-grant)
                  before its access grant started, so the recipient may be
                  unable to access the space. This usually points to a problem
                  that needs attention, such as an offline or disconnected
                  device. Seam keeps retrying, and this error clears
                  automatically if the access method is eventually issued.
                properties:
                  created_at:
                    description: Date and time at which Seam created the error.
                    format: date-time
                    type: string
                  error_code:
                    description: >-
                      Unique identifier of the type of error. Enables quick
                      recognition and categorization of the issue.
                    enum:
                      - failed_to_issue
                    type: string
                  message:
                    description: >-
                      Detailed description of the error. Provides insights into
                      the issue and potentially how to rectify it.
                    type: string
                required:
                  - created_at
                  - message
                  - error_code
                type: object
                x-resource-type: access_method
          type: array
        is_assignment_required:
          description: >-
            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.
          type: boolean
        is_encoding_required:
          description: >-
            Indicates whether encoding with an card encoder is required to issue
            or reissue the plastic card associated with the access method.
          type: boolean
        is_issued:
          description: Indicates whether the access method has been issued.
          type: boolean
        is_ready_for_assignment:
          description: >-
            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.
          type: boolean
        is_ready_for_encoding:
          description: >-
            Indicates whether the access method is ready to be encoded. This is
            true when the credential has been created and the card has not yet
            been issued.
          type: boolean
        issued_at:
          description: Date and time at which the access method was issued.
          format: date-time
          nullable: true
          type: string
        mode:
          description: >-
            Access method mode. Supported values: `code`, `card`, `mobile_key`,
            `cloud_key`.
          enum:
            - code
            - card
            - mobile_key
            - cloud_key
          type: string
        pending_mutations:
          description: >-
            Pending mutations for the [access
            method](/use-cases/granting-access/creating-an-access-grant).
            Indicates operations that are in progress.
          items:
            discriminator:
              propertyName: mutation_code
            oneOf:
              - description: >-
                  Seam is in the process of provisioning access for this access
                  method on new devices.
                properties:
                  created_at:
                    description: Date and time at which the mutation was created.
                    format: date-time
                    type: string
                  from:
                    description: Previous device configuration.
                    properties:
                      device_ids:
                        description: Previous device IDs where access was provisioned.
                        items:
                          format: uuid
                          type: string
                        type: array
                    required:
                      - device_ids
                    type: object
                  message:
                    description: Detailed description of the mutation.
                    type: string
                  mutation_code:
                    description: >-
                      Mutation code to indicate that Seam is in the process of
                      provisioning access for this access method on new devices.
                    enum:
                      - provisioning_access
                    type: string
                  to:
                    description: New device configuration.
                    properties:
                      device_ids:
                        description: New device IDs where access is being provisioned.
                        items:
                          format: uuid
                          type: string
                        type: array
                    required:
                      - device_ids
                    type: object
                required:
                  - created_at
                  - message
                  - mutation_code
                  - from
                  - to
                type: object
              - description: >-
                  Seam is in the process of revoking access for this access
                  method from devices.
                properties:
                  created_at:
                    description: Date and time at which the mutation was created.
                    format: date-time
                    type: string
                  from:
                    description: Previous device configuration.
                    properties:
                      device_ids:
                        description: Previous device IDs where access existed.
                        items:
                          format: uuid
                          type: string
                        type: array
                    required:
                      - device_ids
                    type: object
                  message:
                    description: Detailed description of the mutation.
                    type: string
                  mutation_code:
                    description: >-
                      Mutation code to indicate that Seam is in the process of
                      revoking access for this access method from devices.
                    enum:
                      - revoking_access
                    type: string
                  to:
                    description: New device configuration.
                    properties:
                      device_ids:
                        description: New device IDs where access should remain.
                        items:
                          format: uuid
                          type: string
                        type: array
                    required:
                      - device_ids
                    type: object
                required:
                  - created_at
                  - message
                  - mutation_code
                  - from
                  - to
                type: object
              - description: >-
                  Seam is in the process of updating the access times for this
                  access method.
                properties:
                  created_at:
                    description: Date and time at which the mutation was created.
                    format: date-time
                    type: string
                  from:
                    description: Previous access time configuration.
                    properties:
                      ends_at:
                        description: Previous end time for access.
                        format: date-time
                        nullable: true
                        type: string
                      starts_at:
                        description: Previous start time for access.
                        format: date-time
                        nullable: true
                        type: string
                    required:
                      - starts_at
                      - ends_at
                    type: object
                  message:
                    description: Detailed description of the mutation.
                    type: string
                  mutation_code:
                    description: >-
                      Mutation code to indicate that Seam is in the process of
                      updating the access times for this access method.
                    enum:
                      - updating_access_times
                    type: string
                  to:
                    description: New access time configuration.
                    properties:
                      ends_at:
                        description: New end time for access.
                        format: date-time
                        nullable: true
                        type: string
                      starts_at:
                        description: New start time for access.
                        format: date-time
                        nullable: true
                        type: string
                    required:
                      - starts_at
                      - ends_at
                    type: object
                required:
                  - created_at
                  - message
                  - mutation_code
                  - from
                  - to
                type: object
          type: array
        warnings:
          type: array
          description: >-
            Warnings associated with the [access
            method](/use-cases/granting-access/creating-an-access-grant).
          items:
            type: object
            properties:
              error_code:
                type: string
                description: Error or warning code.
              message:
                type: string
                description: Human-readable description.
              created_at:
                type: string
                format: date-time
                description: When this error or warning was generated.
        workspace_id:
          description: ID of the Seam workspace associated with the access method.
          format: uuid
          type: string
      required:
        - workspace_id
        - access_method_id
        - display_name
        - mode
        - created_at
        - issued_at
        - is_issued
        - display_status
        - warnings
        - errors
        - pending_mutations
      type: object
      x-route-path: /access_methods/unmanaged
  securitySchemes:
    pat_with_workspace:
      bearerFormat: API Token
      scheme: bearer
      type: http
    console_session_with_workspace:
      bearerFormat: Console Session Token
      scheme: bearer
      type: http
    api_key:
      bearerFormat: API Key
      scheme: bearer
      type: http
    support_read_only_token:
      bearerFormat: Support Read-Only Token
      scheme: bearer
      type: http

````