How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Revolut Terminals API

Operations for managing Revolut Terminal devices and push payment integrations with Point of Sale (POS) systems.The Terminals API enables POS software providers to integrate with Revolut Terminal devices for accepting in-person payments through a **push payments** model. This server-to-server integration allows your POS system to:- Discover available terminals at specific locations- Push payment requests to physical terminal devices- Track payment intent and payment status in real-time- Cancel pending payment requests when needed## Push payments workflow1. **Terminal discovery:** Use the [Retrieve terminal list](https://developer.revolut.com/docs/api/merchant#retrieve-terminal-list) endpoint to find available terminals at a location (filtered by `operation_mode=pos`)1. **Payment intent creation:** Push a payment request to a specific terminal using [Create a payment intent](https://developer.revolut.com/docs/api/merchant#create-payment-intent)1. **Status tracking:** Poll the payment intent status until completion using [Retrieve a payment intent](https://developer.revolut.com/docs/api/merchant#retrieve-payment-intent) endpoint1. **Payment confirmation:** Once the payment intent reaches `completed` state, [retrieve the final payment status](https://developer.revolut.com/docs/api/merchant#retrieve-payment-details) using the returned `payment_id`:::infoFor detailed implementation guidance, see: [Push payments to Revolut Terminal](https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments).:::

Revolut Terminals API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Terminals. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 1 operation across 1 path, and defines 12 schemas. It is described by OpenAPI 3.2.0, at version 2026-04-20.

Requests are made against 2 base URLs: https://merchant.revolut.com, https://sandbox-merchant.revolut.com.

1 operations 1 paths 12 schemas 1 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-04-20
Base URL
https://b2b.revolut.com/api/1.0
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Revolut Terminals API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Api-Key). By default, every request must be authenticated.

  • Api-Key — Each Merchant API request must contain an authorization header in the following format: 'Authorization: Bearer ' To use this API, you need to generate API keys…

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 GET. Each is listed below with its method, path, parameters, and response codes.

Terminals 1

Operations for managing Revolut Terminal devices and push payment integrations with Point of Sale (POS) systems. The Terminals API enables POS software providers to integrate with…

GET
/api/terminals
Retrieve terminal list
retrieveTerminalList 4 params → 200400401

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are Terminal (7 properties), Error-v2 (3 properties), Terminals-Response (1 property). Each schema is shown below with its type and property counts.

Terminal-Type
string
The hardware type/model of the terminal device.
Terminal-Id
string
The unique identifier of the terminal.
Terminal-Operation-Mode
string
The operation mode of the terminal. | Value | Description | |-------|-------------| | pos | Returns only terminals in Pay at Counter mode | | paymentacceptance…
Terminal
object
Represents a Revolut Terminal device.
7 properties 7 required
Terminal-Online
boolean
Indicates whether the terminal is currently online and connected. | Value | Description | |-------|-------------| | true | Terminal is online and available | |…
Terminals-Response
object
Response containing a list of terminals.
1 property 1 required
Error-v2
object
3 properties
Terminal-Name
string
The name of the terminal device.
Terminal-Battery-Level
integer
The current battery level of the terminal as a percentage (0-100).
Terminal-Last-Online-At
string
The date and time when the terminal was last seen online.
Terminals
array
List of terminal devices.
Terminal-Serial-Number
string
The serial number of the terminal device.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revolut-terminals-api-openapi.yml Raw ↑

Other APIs Revolut publishes across the network.

Revolut Accounting API
Revolut Accounting categories API
Revolut Accounts API
Revolut Apple Pay merchant registration API
Revolut Applications API
Revolut Balance API
Revolut Card invitations API
Revolut Cards API
Revolut Configuration API
Revolut Counterparties API
Revolut Customers API
Revolut Disputes API
Where this information came from

This is an independent, third-party profile of Revolut Terminals API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.