---
title: "Terminals:Browse"
method: GET
path: "/terminals"
tags: ["Terminals"]
---

# Terminals:Browse

`GET /terminals`

Get a list of all terminals linked to your account. Including the contract details,  active terminal brands and the actual status of a terminal

## Query parameters

- `limit` integer
- `page` integer
- `merchant` object
  - `eq` string — Get results that equal the given value
  - `neq` string — Get results that do not equal the given value

## Response `200`

Ok.

- object
  - `total` integer
  - `count` integer
  - `pages` integer
  - `terminals` object[]
    - `code` Code — unresolved $ref
    - `name` Name — unresolved $ref
    - `attribution` Attribution — unresolved $ref
    - `status` Status — unresolved $ref
    - `connectionStatus` ConnectionStatus — unresolved $ref
    - `merchant` MerchantMinimal
      - `code` string, required — The merchant id of your company starting with M.
      - `name` string, required — The name of your merchant.
      - `status` string, required — Merchant state
      - `incorporationCountry` string — The incorporationCountry field represents the country in which the entity is legally registered or incorporated.
    - `service` object
      - `id` Id — unresolved $ref
      - `status` Status — unresolved $ref
      - `name` Name — unresolved $ref
      - `mcc` integer — The Merchant Category Code (mcc) of this service.
      - `contactPhone` string — The primary contact phone number.
      - `contactEmail` string — The primary contact email address.
    - `tradeName` object
      - `code` Code — unresolved $ref
      - `name` Name — unresolved $ref
    - `description` Description — unresolved $ref
    - `hardwareCode` HardwareCode — unresolved $ref
    - `serialNumber` SerialNumber — unresolved $ref
    - `terminalTypeCode` TerminalTypeCode — unresolved $ref
    - `terminalType` TerminalType — unresolved $ref
    - `supplier` Supplier — unresolved $ref
    - `terminalServer` TerminalServer — unresolved $ref
    - `ecrProtocol` EcrProtocol — unresolved $ref
    - `contractStartDate` ContractStartDate — unresolved $ref
    - `contractEndDate` ContractEndDate — unresolved $ref
    - `paymentTypes` PaymentTypes — unresolved $ref
    - `terminalBrands` TerminalBrand
      - `id` integer — The terminal contract enddate.
      - `name` string — The terminal contract enddate.
      - `image` string — The terminal contract enddate.
      - `acquirer` string — The terminal acquirer
      - `acquirerTid` string — The terminal contract enddate.
      - `acquirerMid` string — The terminal contract number
      - `acquirerChecksum` string — The terminal contract enddate.
      - `paymentTypes` object[] — The terminal payment type.
        - `paymentType` string
      - `createdAt` CreatedAt — unresolved $ref
      - `createdBy` CreatedBy — unresolved $ref
      - `modifiedAt` ModifiedAt — unresolved $ref
      - `modifiedBy` ModifiedBy — unresolved $ref
      - `deletedAt` DeletedAt — unresolved $ref
      - `deletedBy` DeletedBy — unresolved $ref
    - `location` object
      - `streetName` StreetName — unresolved $ref
      - `streetNumber` StreetNumber — unresolved $ref
      - `zipCode` ZipCode — unresolved $ref
      - `city` City — unresolved $ref
      - `countryCode` CountryCode — unresolved $ref
    - `settings` Settings — unresolved $ref
    - `createdAt` CreatedAt — unresolved $ref
    - `createdBy` CreatedBy — unresolved $ref
    - `modifiedAt` ModifiedAt — unresolved $ref
    - `modifiedBy` ModifiedBy — unresolved $ref
    - `deletedAt` DeletedAt — unresolved $ref
    - `deletedBy` DeletedBy — unresolved $ref
  - `_links` object
    - `first` object
      - `href` Href — unresolved $ref
    - `previous` object
      - `href` Href — unresolved $ref
    - `next` object
      - `href` Href — unresolved $ref
    - `last` object
      - `href` Href — unresolved $ref
    - `self` object
      - `href` Href — unresolved $ref
      - `rel` Rel — unresolved $ref
      - `type` Type — unresolved $ref

## Other responses

- `401` — Unauthorized. Supplied credentials are invalid
- `403` — Forbidden. Supplied credentials have no rights
- `405` — Used HTTP method is not allowed
- `406` — Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `429` — Rate limit reached.
- `500` — An internal error occurred

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/revisions/2bc260c7bdfc/schema)