---
title: "Get merchant"
method: GET
path: "/partner-integration/v1/merchants/{id}"
tags: ["Partner Integration.Merchants"]
---

# Get merchant

`GET /partner-integration/v1/merchants/{id}`

Retrieve information about an existing merchant.

## Path parameters

- `id` string, required

## Response `200`

A successful response.

- V1Merchant — Information needed to register a merchant.
  - `appId` string — The id of the application associated with the merchant. Output only.
  - `categoryCode` string, required — The merchant category code (MCC) of the merchant, as a four-digit code (ISO 18245).
  - `countryCode` string, required — The merchant's domicile, the country in which the merchant is legally registered, as a two-letter code (ISO 3166-1 alpha-2).
  - `externalId` string — The external id of the merchant.
  - `id` string — The id of the merchant. Output only.
  - `name` string, required — The name of the merchant. Can only have alphanumerics plus full stop, hyphen, forward slash or ampersand.
  - `organizationNumber` string, required — The organization/company/registration number of the merchant. The identification number given to a company when it is registered or incorporated.
  - `status` 'PENDING' | 'VERIFIED' | 'DECLINED' — Status of the merchant. - PENDING: Merchant has not yet been verified. - VERIFIED: Merchant has been successfully verified. - DECLINED: Merchant verification has failed.
  - `url` string, required — The url to the merchant's website without a path, e.g. https://example.com.

## Other responses

- `400` — The request does not pass validation. Check the error message or the documentation of each field for more information.
- `401` — The scopes associated with the access token is not allowed the resource.
- `403` — The resource does not belong to subject associated with the access token.
- `404` — The merchant could not be found.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)