---
title: "Retrieve a device configuration"
method: GET
path: "/processing-terminals/{processingTerminalId}/device-configurations/{model}"
tags: ["processingTerminals"]
---

# Retrieve a device configuration

`GET /processing-terminals/{processingTerminalId}/device-configurations/{model}`

Use this method to retrieve configuration details for a device associated with a processing terminal.

Our gateway returns the following details about the configuration:

- Supported features
- Applications
- Certificates and revoked certificates
- Visual assets

## Path parameters

- `processingTerminalId` string, required
- `model` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns the device configuration details.

- DeviceConfiguration — Object that contains the configuration of the device type/model.
  - `model` string, required — Type or model of the device.
  - `manufacturer` string — Company that manufactured the device.
  - `supportsMagStripe` boolean — Indicates if the device can run swiped transactions.
  - `supportsIcc` boolean — Indicates if the device can read chip cards.
  - `supportsKeyed` boolean — Indicates if the device can run keyed transactions.
  - `supportsContactless` boolean — Indicates if the device can run contactless transactions.
  - `supportsPinEntry` boolean — Indicates if the device can accept PIN entry.
  - `supportsOutputPrinting` boolean — Indicates if the device can print receipts.
  - `supportsOutputDisplaying` boolean — Indicates if the device can display information on a screen.
  - `supportsAttended` boolean — Indicates if a clerk must operate the device.
  - `supportsUnattended` boolean — Indicates if the device can operate without a clerk present.
  - `applications` EmvApplication[] — Array of emvApplication objects. Each object contains information about an EMV application supported by the device.
    - `identifier` string — Unique identifier of the EMV application, also known as the Application Identifier (AID).
    - `version` string — Version number of the EMV application.
    - `card` string — Card brand associated with the EMV application.
    - `matchType` 'full' | 'partialVisa' | 'partialEuropay' — Indicates how the terminal matches the EMV application identifier during card selection. - `full` – The terminal requires an exact match of the full application identifier. - `partialVisa` – The terminal uses partial matching as defined by Visa. - `partialEuropay` – The terminal uses partial matching as defined by Europay and Mastercard.
  - `certificates` EmvCertificate[] — Array of emvCertificate objects. Each object contains information about an EMV certificate used by the device.
    - `rid` string — Unique identifier of the payment application provider, also known as the Registered Application Provider Identifier (RID).
    - `exponent` string — Public key exponent for the certificate.
    - `certificate` string — Certificate data encoded in hexadecimal format.
  - `revokedCertificates` EmvCertificate[] — Array of emvCertificate objects. Each object contains information about a revoked EMV certificate.
    - `rid` string — Unique identifier of the payment application provider, also known as the Registered Application Provider Identifier (RID).
    - `exponent` string — Public key exponent for the certificate.
    - `certificate` string — Certificate data encoded in hexadecimal format.
  - `visualAssets` VisualAsset[] — Array of visualAsset objects. Each object contains information about a visual asset that the device displays.
    - `type` 'image', required — Format of the visual asset.
    - `scope` 'logo' | 'idleScreen', required — Location of the visual asset.
    - `url` string, required — URL of the visual asset.

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `406` — Not acceptable
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)