---
title: "List terminal pairing codes"
method: GET
path: "/v2/terminals/pairing-codes"
tags: ["Terminals API"]
---

# List terminal pairing codes

`GET /v2/terminals/pairing-codes`

> ℹ️ **Test mode**
>
> This endpoint currently does not support test mode yet.

Returns your pairing codes: `active`, `expired`, and `revoked`. Results are paginated.

We keep a pairing code for one month after it is revoked or expires, then delete it. Deleted codes drop out of
this list. Active pairing codes are never deleted.

## Query parameters

- `from` string, nullable
- `limit` integer, nullable
- `sort` 'asc' | 'desc'
- `profileId` string

## Headers

- `idempotency-key` string

## Response `200`

A list of terminal pairing code objects. For a complete reference of the terminal pairing code object, refer to
the [Get terminal pairing code endpoint](terminals-get-pairing-code) documentation.

## Other responses

- `400` — The request contains issues. For example, if the specified `from` value is not a valid ID.
- `429` — Rate Limit has been reached.

## Changes

> 79 revisions in range; 9 not diffed.

- **2026-07-08** `1bcb76dbe9ea` — 1 breaking
  - the `count` response property's min was decreased from `1.00` to `0.00` for the response status `200`
- **2026-05-21** `4c6a6cf47ca8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/terminals/pairing-codes/get.md)

---

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