---
title: "Get merchant"
method: GET
path: "/merchants/{id}"
tags: ["Merchants"]
---

# Get merchant

`GET /merchants/{id}`

Retrieve details for a merchant.

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `success` true, required
  - `item` GenieMerchant, required — A merchant match result from Genie.
    - `_id` string, required — The unique merchant identifier.
    - `name` string, required — The merchant's name (trading name).
    - `logo` string, required — A URL referencing the merchant's logo. If no logo is available, a placeholder image is provided.
    - `logo_is_placeholder` boolean — A boolean flag, set to `true` if the `logo` URL points to a placeholder image rather than the merchant's real logo (i.e. there is no logo available for this merchant). This flag may be useful if you would prefer not to display placeholder logos or replace them with your own.
    - `website` string — The URL for the merchant's website.
    - `phone` string — The merchant's phone number.
    - `nzbn` string — The merchant's NZBN (New Zealand Business Number).
    - `location` GenieLocation — A physical location.
      - `accuracy` 'country' | 'region' | 'locality' | 'sublocality' | 'establishment', required
      - `formatted` string, required
      - `coordinates` GenieCoordinates, required — Latitude/longitude location coordinates.
        - `lat` number, required
        - `lon` number, required
      - `address` GenieAddress
        - `street` string, required
        - `suburb` string
        - `city` string, required
        - `region` string, required
        - `country` string, required
        - `postal_code` string, required
    - `tags` GenieTag[] — Tags that apply to the merchant. For example, to indicate that the merchant provides a subscription service.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate Limiting
- `500` — Internal Server Error

---

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