v1

latestOpenAPI 3.0.02026-07-26224386470.0 KB

Merchants

List merchants

Get a paginated list of merchants with optional name and group_id filtering. Results are ordered by merchant ID for stable pagination.

get/api/merchants/list

Query parameters

namestring

Filter merchants by name (full or partial match)

group_idstring

Filter merchants by group ID

limitinteger

Number of merchants to return per page

offsetinteger

Number of merchants to skip

Response

List of merchants with pagination metadata

has_moreboolean

limitinteger

offsetinteger

totalinteger

Example response

{
  "data": [
    {
      "categories": [
        {
          "code": "7311",
          "description": "Advertising services",
          "slug": "advertising_services"
        }
      ],
      "heron_id": "mrc_gkcx4tKTGc2T5v2QiJVuMV"
    }
  ]
}