Skip to main content
GET
Get Customers

Authorizations

x-revolv3-token
string
header
required

Headers

Client-Request-Id
string

Optional identifier generated by the client to match its own logs with this request.

Allowed values: 1 to 128 characters, letters, digits and ., _, :, -.

Examples: order-12345, 3f2b8c1e-9d4a-4e7b-a1c5-6b0d2e8f7a91 (GUID), checkout:2026-11-02.17, retry_1.order-12345.

A valid value is returned in the Client-Request-Id response header and is stored with Revolv3 request logs, so it can be used when contacting support. An invalid value is ignored and the request is processed normally. Do not send sensitive data in this header.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]{1,128}$

Query Parameters

merchantCustomerRefId
string
Maximum string length: 100
firstName
string
Maximum string length: 150
lastName
string
Maximum string length: 150

Response

OK

customerId
integer<int64>
Required range: 1 <= x <= 1000000000
merchantCustomerRefId
string | null
Maximum string length: 100
firstName
string | null
Maximum string length: 150
lastName
string | null
Maximum string length: 150