# List bound devices

Returns a list of devices that your customers have verified using the device binding process.

Endpoint: GET /v1/mfa/devices
Version: 1.0

## Query parameters:

  - `page[size]` (integer)
    Use this filter to specify the size of each page of results.

  - `page[number]` (integer)
    Use this filter to return only the devices on a certain page of the response.

  - `filter[person_id]` (string)
    Use this filter to return only devices that belong to a specific person.

  - `filter[include_deleted]` (string)
    Boolean value that determines whether or not the API should also return deleted devices. Default value is .

## Response 200 fields (application/json):

  - `id` (string)
    The ID of the device.
    Example: "20f892fdc6414320b5b1df612f833edb"

  - `name` (string)
    The name of the device.
    Example: "Samsung Galaxy S20"

  - `person_id` (string)
    The ID of the person who registered the device.
    Example: "83caf49280604836bdbb41ba33d8cper"

  - `created_at` (string)
    The date and time when the device was registered.
    Example: "2022-06-30T22:19:37Z"

  - `deleted_at` (string)
    (For deleted devices only) The date and time when the device was deleted.

## Response 400 fields (application/json):

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `status` (integer)
    Example: "400"

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `detail` (string)
    Example: "Cannot connect to database."

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `error_code` (string)
    a static error_code that can be used to identify the error
    Example: "telephone_number_not_found"

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.status` (integer)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.code` (string)

  - `errors.title` (string)

  - `errors.detail` (string)

  - `errors.id` (string)
    Correlation/Request ID

## Response 403 fields (application/json):

  - `title` (string)
    Example: "Unauthorized Action"

  - `status` (integer)
    Example: "403"

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

  - `code` (string)
    Example: "unauthorized_action"

  - `error_code` (string)
    a static error_code that can be used to identify the error
    Example: "forbidden"

## Response 404 fields (application/json):

  - `title` (string)
    Example: "Model Not Found"

  - `status` (integer)
    Example: "404"

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `detail` (string)
    Example: "Couldn't find 'Account' for id 'DE24112233445566'."

  - `code` (string)
    Example: "model_not_found"

  - `error_code` (string)
    a static error_code that can be used to identify the error
    Example: "not_found"

## Response 409 fields (application/json):

  - `errors` (array)

  - `errors.status` (integer)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.code` (string)

  - `errors.title` (string)

  - `errors.detail` (string)

  - `errors.id` (string)
    Correlation/Request ID

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (integer)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."

  - `error_code` (string)
    a static error_code that can be used to identify the error
    Example: "generic_error"