# List Devices Retrieve a list of . For details on how to query endpoints using the available parameters, see Query Parameters. Endpoint: GET /devices Security: BasicAuth ## Query parameters: - `limit` (integer) The numbers of items to return. Example: 3 - `created_at.gte` (string) Filter where is after the given date. Example: "2022-09-27T11:21:23" - `created_at.lte` (string) Filter where is before the given date. Example: "2026-09-27T11:21:23" - `updated_at.gte` (string) Filter where is after the given date. Example: "2022-09-27T11:21:23" - `updated_at.lte` (string) Filter where is before the given date. Example: "2026-09-27T11:21:23" - `after_cursor` (string) Return every resource created after the cursor value. - `before_cursor` (string) Return every resource created before the cursor value. - `tags.key` (string) Filter by the tag's key. For more information, see Tags. - `tags.value` (any) Filter by the tag's value. For more information, see Tags. Example: "business_card" - `application_id` (string) Filter by ID. Example: "APc9vhYcPsRuTSpKD9KpMtPe" - `merchant_id` (string) Filter by ID. - `name` (string) Filter by the name. - `model` (string) Filter by the model. Example: "PAX_A800" - `description` (string) Filter by the description. - `serial_number` (string) Filter by the serial number. Example: "2210074802" - `enabled` (boolean) Filter by the enabled value. Example: true ## Response 200 fields (application/json): - `page` (object) Details the page that's returned. - `page.limit` (integer) The number of entries to return. - `page.next_cursor` (string,null) The cursor to use for the next page of results. - `_embedded` (object) List of objects. - `_embedded.disputes` (array) objects. - `_embedded.disputes.id` (string) The ID of the activated . - `_embedded.disputes.created_at` (string) Timestamp of when the object was created. - `_embedded.disputes.updated_at` (string) Timestamp of when the object was last updated. - `_embedded.disputes.android_version` (string) The Android version installed on the . - `_embedded.disputes.configuration` (object) Information used to configure how the handles transaction flows. - `_embedded.disputes.configuration.allow_debit` (boolean) Enable processing of transactions through Debit rails. If set to , Debit card transactions will instead be processed through Credit rails. - `_embedded.disputes.configuration.allow_standalone_authorizations` (boolean) Sets whether the device allows initialization authorizations on its interface. and only. - `_embedded.disputes.configuration.allow_standalone_refunds` (boolean) Sets whether the device allows initialization refunds on its interface. and only. - `_embedded.disputes.configuration.allow_standalone_sales` (boolean) Sets whether the device allows initialization sales on its interface. - `_embedded.disputes.configuration.bypass_device_on_capture` (boolean,null) Sets whether or not the device will be used to capture transactions. This field should be set to unless there are special circumstances. - `_embedded.disputes.configuration.check_for_duplicate_transactions` (boolean) Sets if the device will check for duplicate transactions. only. - `_embedded.disputes.configuration.display_tip_on_receipt` (boolean) Sets whether the device will display the blank tip amount on the receipt for authorizations to be later captured. and only. - `_embedded.disputes.configuration.idle_image_file_id` (string,null) The ID of the file to be displayed on the device when it is idle. Passing a value of resets the device's idle image to the default. - `_embedded.disputes.configuration.idle_message` (string,null) Sets the idle message text on the terminal. This is what will be presented on the welcome screen. and only. - `_embedded.disputes.configuration.prompt_amount_confirmation` (boolean) Sets if the cardholder needs to confirm the amount they'll pay. only. - `_embedded.disputes.configuration.prompt_for_signature` (string) Determines when the terminal prompts for an e-signature. - : The terminal will always request an e-signature. - : The terminal will never request an e-signature. - : The terminal follows card network recommendations on whether to prompt for a signature. - : The terminal requests an e-signature only when the transaction amount is greater than or equal to . Enum: "ALWAYS", "NEVER", "ON_NETWORK_RECOMMENDATION", "ON_THRESHOLD_AMOUNT" - `_embedded.disputes.configuration.prompt_manual_entry` (boolean) Sets if the device allows for manual entry as a card input method. and only. On if this is set to true manual entry will be the default entry option. - `_embedded.disputes.configuration.prompt_receipt_confirmation` (boolean) Sets whether or not the device presents a screen prompting the buyer to print receipt at the end of the transaction flow. and only. - `_embedded.disputes.configuration.prompt_tip_on_screen` (boolean) Sets whether the device will display the suggested tipping screen. and only. - `_embedded.disputes.configuration.signature_threshold_amount` (any) The transaction amount at which the terminal prompts for an e-signature. - `_embedded.disputes.configuration.surcharge_basis_points` (integer) Represents the transaction amount that a charges the buyer when creating a or an . The value cannot exceed (i.e., 3%). For devices on Standalone Mode, the Finix Payment Application on the terminal will calculate and send a or an request with the surcharge added. Customers integrated directly into Finix API must contact Support to incorporate surcharging appropriately into their integration. - `_embedded.disputes.configuration.tipping_details` (object) An object that sets the configurations for the tipping page if it appears. and only. - `_embedded.disputes.configuration.tipping_details.allow_custom_tip` (boolean) Allows the buyer to set a custom tip. and only. - `_embedded.disputes.configuration.tipping_details.fixed_options` (array) Sets the fixed amount that will be displayed on the terminal. Defaults to . Must be three integer values that represent cent values. and only. - `_embedded.disputes.configuration.tipping_details.percent_options` (array) Sets the percentages that will be displayed on the terminal. Defaults to . Must be three integer values that represent percentages. and only. - `_embedded.disputes.configuration.tipping_details.percent_tipping_threshold` (integer) The inclusive value at which the terminal will present a percent based prompt instead of a fixed value prompt. Defaults to . and only. - `_embedded.disputes.description` (string,null) Additional information about device (e.g. self serving terminal). - `_embedded.disputes.enabled` (boolean) Whether the is enabled. indicates disabled. - `_embedded.disputes.firmware_version` (string) The current version of the device's firmware. - `_embedded.disputes.merchant` (string) ID of the resource. Example: "MUxxxxxxxxxxxxxxxxxx" - `_embedded.disputes.model` (string) The model type of the . Enum: "PAX_A800", "PAX_A920PRO", "D135" - `_embedded.disputes.name` (string) The display name of the used for filtering purposes. - `_embedded.disputes.payment_app_version` (string) The device’s current app version. - `_embedded.disputes.prompt_signature` (string) When to prompt for a signature. Enum: "ALWAYS" - `_embedded.disputes.serial_number` (string,null) The serial_number is a unique identifier for the , located on the back and typically composed of ~16 digits. Ensure the serial number is set before activating the , though it can also be added later using a PUT request. - `_embedded.disputes.tags` (object,null) Include up to 50 pairs to annotate requests with custom metadata. - Maximum character length for individual is 40. - Maximum character length for individual is 500. (For example, , , ) - `_embedded.disputes._links` (object) For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these to make your follow-up requests and quickly access relevant IDs. - `_embedded.disputes._links.authorizations` (object) - `_embedded.disputes._links.authorizations.href` (string) - `_embedded.disputes._links.merchant` (object) Link to the resource that was used in the request. - `_embedded.disputes._links.self` (object) Link to the resource that was used in the request. - `_embedded.disputes._links.transfers` (object) ## Response 401 fields (application/json): - `total` (integer) - `_embedded` (object) - `_embedded.errors` (array) - `_embedded.errors.code` (string) Enum: "UNKNOWN" - `_embedded.errors.logref` (object) - `_embedded.errors.message` (string) - `_embedded.errors._links` (object) - `_embedded.errors._links.self` (object) - `_embedded.errors._links.self.href` (string) - `_embedded.errors._links.source` (object) ## Response 403 fields (application/json): - `total` (integer) - `_embedded` (object) - `_embedded.errors` (array) - `_embedded.errors.code` (string) Enum: "FORBIDDEN" - `_embedded.errors.logref` (object) - `_embedded.errors.message` (string) - `_embedded.errors._links` (object) - `_embedded.errors._links.source` (object) - `_embedded.errors._links.source.href` (string) ## Response 406 fields (application/json): - `total` (integer) - `_embedded` (object) - `_embedded.errors` (array) - `_embedded.errors.code` (string) Enum: "NOT_FOUND" - `_embedded.errors.logref` (object) - `_embedded.errors.message` (string) - `_embedded.errors._links` (object) - `_embedded.errors._links.source` (object) - `_embedded.errors._links.source.href` (string)