Merchants

Get Merchant

Changed on Oct 14, 2026

Returns a Merchant for a valid Merchant code.

get/v1/merchants/{merchant_code}

Request

Base URL
https://api.sumup.com
URL
https://api.sumup.com/v1/merchants/{merchant_code}
Auth
- HTTP bearer
- or OAuth 2
  Authorization code: https://api.sumup.com/authorize
  Token URL: https://api.sumup.com/token scopes: user.profile, user.profile_readonly

Path parameters

merchant_codestring required

Example:MK10CL2A

Short unique identifier for the merchant.

Response

Returns a Merchant for a valid identifier.

merchant_codestring required

Short unique identifier for the merchant.

organization_idstring

ID of the organization the merchant belongs to (if any).

business_typestring

The business type.

sole_trader: The business is run by an self-employed individual.
company: The business is run as a company with one or more shareholders
partnership: The business is run as a company with two or more shareholders that can be also other legal entities
non_profit: The business is run as a nonprofit organization that operates for public or social benefit
government_entity: The business is state owned and operated

countrystring required

An ISO3166-1 alpha-2 country code. This definition users oneOf with a two-character string type to allow for support of future countries in client code.

avatarstring uri

A user-facing small-format logo for use in dashboards and other user-facing applications. For customer-facing branding see merchant.business_profile.branding.

aliasstring

A user-facing name of the merchant account for use in dashboards and other user-facing applications. For customer-facing business name see merchant.business_profile.

default_currencystring required

Three-letter ISO currency code representing the default currency for the account.

default_localestring required

Merchant's default locale, represented as a BCP47 RFC5646 language tag. This is typically an ISO 639-1 Alpha-2 ISO639‑1 language code in lowercase and an ISO 3166-1 Alpha-2 ISO3166‑1 country code in uppercase, separated by a dash. For example, en-US or fr-CA. In multilingual countries this is the merchant's preferred locale out of those, that are officially spoken in the country. In a countries with a single official language this will match the official language.

sandboxboolean

True if the merchant is a sandbox for testing.

metaMeta

A set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

Warning: Updating Meta will overwrite the existing data. Make sure to always include the complete JSON object.

versionstring

The version of the resource. The version reflects a specific change submitted to the API via one of the PATCH endpoints.

change_statusstring

Reflects the status of changes submitted through the PATCH endpoints for the Merchant or Persons. If some changes have not been applied yet, the status will be pending. If all changes have been applied, the status done. The status is only returned after write operations or on read endpoints when the version query parameter is provided.

created_atstring date-time required

The date and time when the resource was created. This is a string as defined in RFC 3339, section 5.6.

updated_atstring date-time required

The date and time when the resource was last updated. This is a string as defined in RFC 3339, section 5.6.

Example response

{
  "merchant_code": "MK01A8C2",
  "organization_id": "G0UZPVAX",
  "company": {
    "name": "Gin & Doughnuts Bar GmbH",
    "merchant_category_code": "1532",
    "legal_type": "de.freiberufler",
    "address": {
      "street_address": [
        "Paul-Linke-Ufer 39-40",
        "2. Hinterhof"
      ],
      "post_code": "10999",
      "city": "Berlin",
      "country": "DE"
    },
    "trading_address": {
      "street_address": [
        "Paul-Linke-Ufer 39-40",
        "2. Hinterhof"
      ],
      "post_code": "10999",
      "city": "Berlin",
      "country": "DE"
    },
    "identifiers": [
      {
        "ref": "de.gmbh",
        "value": "HRB 123456"
      }
    ],
    "phone_number": "+420123456789",
    "website": "https://www.sumup.com",
    "attributes": {}
  },
  "country": "BR",
  "business_profile": {
    "name": "Example Coffee",
    "dynamic_descriptor": "Example Coffee",
    "website": "https://example.com",
    "email": "contact@example.com",
    "phone_number": "+420123456789",
    "address": {
      "street_address": [
        "Paul-Linke-Ufer 39-40",
        "2. Hinterhof"
      ],
      "post_code": "10999",
      "city": "Berlin",
      "country": "DE"
    },
    "branding": {
      "footer_text": "Thanks for shopping with us.",
      "primary_color": "#FF4B3A",
      "primary_color_fg": "#FF4B3A",
      "secondary_color": "#FF4B3A",
      "secondary_color_fg": "#FF4B3A",
      "background_color": "#FF4B3A"
    }
  },
  "default_currency": "EUR",
  "default_locale": "de-DE",
  "meta": {},
  "classic": {
    "id": 1234
  },
  "version": "chng_01HS0KG3MPVEVWW85E3KNXH55J",
  "created_at": "2021-08-31T12:00:00Z",
  "updated_at": "2021-08-31T12:00:00Z"
}

Changes

Oct 14, 20260f66b0a52002 Revision changes
- breaking
  the /// response property's maxLength was unset from 2 for the response status
- breaking
  the // response property's maxLength was unset from 64 for the response status
- breaking
  the // response property's maxLength was unset from 16 for the response status
- breaking
  the /// response property's minLength was decreased from 2 to 0 for the response status
- breaking
  the // response property's minLength was decreased from 4 to 0 for the response status
- breaking
  the /// response's property type changed from string to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the // response's property type changed from string to no type for status
- breaking
  the // response's property type changed from string to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- info
  added subschema #1 to the // response property allOf list for the response status
- info
  added subschema #1 to the // response property allOf list for the response status
- info
  added subschema #1 to the /// response property allOf list for the response status
- info
  added subschema #1 to the // response property allOf list for the response status
- info
  added subschema #1 to the // response property allOf list for the response status
- info
  the /// response's property pattern ^[A-Z]{2}$ was removed for the status
- info
  the // response's property pattern ^[a-z]{2}\.[a-z_]+$ was removed for the status
Sep 4, 20269d793febdaeb Revision changes
- warning
  deleted the query request parameter version
- info
  the //// response's property pattern ^[a-z]{2}\.[a-z_]+$ was added for the status
- info
  the // response's property pattern ^[a-z]{2}\.[a-z_]+$ was added for the status
- info
  the // response's property pattern was changed from ^[a-zA-Z0-9 \-+\'_.]{0,30}$ to ^[a-zA-Z0-9 +'_.-]+$ for the status

Operation history (10 revisions)