Lists merchant API keys

Request

GET {{baseURL}}/pay-api/v1/merchants/tokens

This endpoint lists merchant API keys created for merchants under a partner account.

The query parameter filter may be used to further specify API keys to return.

This endpoint requires the API token to be from a partner API key. API tokens generated from a merchant key are not accepted.

See Also:
To list merchants, see GET /pay-api/v1/merchants.
To create a merchant API key, see POST /pay-api/v1/merchants/tokens.
To revoke a merchant API key, see DELETE /pay-api/v1/merchants/tokens/{clientId}.

Security

Bearer

Query

merchantIdstring, (uuid)

Specifies the identifier of the merchant.

If null or omitted, all merchants from the partner aer returned.

Example:merchantId=46063d32-10fa-44cb-b118-20ddd085ce3f

curl -i -X GET \
  'https://developer.flute.com/_mock/api-reference/pay-api/v1/merchants/tokens?merchantId=46063d32-10fa-44cb-b118-20ddd085ce3f' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json

tokensArray of objects or null

Specifies an array of objects identifying a list API keys. These API keys were created for merchants under a partner account or as a standalone merchant.

Response

{
  "tokens": [
    {
      "merchantId": "fae7620d-ab02-4375-bc20-6ff326b917fd",
      "tokenName": "Peppared Street Cafe's API Key",
      "clientId": "3b87fab4-5be4-44d3-9070-5f6ec1dfcbf5",
      "creationDate": "2026-02-19T20:24:52.934Z"
    }
  ]
}