# Get merchant details

> `GET https://api.kustom.co/accountmanagement/v1/merchants/{merchantId}`

Retrieves full details for a given merchant, including status, business information, store information, bank accounts, and settlement schedule.

## Parameters

- `merchantId` (string, path, required) — The unique Kustom merchant identifier (e.g. `A100001`).

## Responses

### 200

Merchant details returned successfully.

`application/json`

- `merchant_id` (string)
- `email` (string)
- `phone` (string)
- `type` (string)
- `country` (string)
- `business_information` (object) — Business information in response payloads.
  - `organization_is_registered` (boolean)
  - `organization_entity_type` (string)
  - `organization_name` (string)
  - `organization_registration_id` (string)
  - `organization_registration_authority` (string)
  - `vat_id` (string)
  - `subject_to_vat` (boolean)
  - `owner` (object) — Owner details in response payloads.
    - `id` (integer) — Internal owner ID.
    - `given_name` (string)
    - `family_name` (string)
    - `personal_id` (string)
    - `title` (string)
    - `date_of_birth` (string)
    - `street_address` (string)
    - `street_address2` (string)
    - `postal_code` (string)
    - `city` (string)
    - `region` (string)
    - `country` (string)
  - `owners[]` (array<object>) Same shape as `owner`.
  - `registered_address` (object) — Address in response payloads.
    - `street_address` (string)
    - `street_address2` (string)
    - `postal_code` (string)
    - `city` (string)
    - `region` (string)
    - `country` (string)
  - `operating_address` (object) — Address in response payloads. Same shape as `registered_address`.
- `store_information` (object) — Store information container in response payloads.
  - `stores[]` (array<object>)
    - `id` (integer) — Internal store ID.
    - `country` (string)
    - `store_name` (string)
    - `organization_category` (string)
    - `homepage_url` (string)
    - `logo_url` (string)
    - `support_email` (string)
    - `support_phone` (string)
- `platform` (string)
- `created_at` (string)
- `last_modified_at` (string)
- `transactions_requested_at` (string)
- `payouts_requested_at` (string)
- `price_plan` (string)
- `custom_data` (object)
  - `key` (any) — Any additional property. The key is free-form; the value has this shape.
- `stakeholders[]` (array<object>)
- `bank_accounts[]` (array<object>)
  - `id` (integer) — Internal bank account ID.
  - `currency_code` (string)
  - `country` (string)
  - `account_type` (string)
  - `account_holder` (string)
  - `routing_number` (string)
  - `account_number` (string)
  - `is_default` (boolean)
- `special_offer` (object) — Special pricing offer details.
  - `id` (string)
  - `valid_until` (string)
  - `percentage_fee` (number)
  - `fixed_fee` (number)
  - `consumed` (boolean)
- `settlement_schedule` (object) — Settlement payout schedule.
  - `delay` (integer) — Number of days delay before settlement.
  - `interval` (string) — Settlement interval (e.g. DAILY, WEEKLY).
  - `day` (string) — Day of the week for weekly settlements. Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`.
- `status` (object) — Current merchant status with full history.
  - `current` (string) — The current merchant status. Enum: `PENDING`, `TRANSACTIONS_DISABLED`, `TRANSACTIONS_ENABLED`, `PAYOUTS_ENABLED`, `ADDITIONAL_REVIEW_1`, `ADDITIONAL_REVIEW_2`, `SUSPENDED`, `PRE_ASSESSMENT_PENDING`, `DORMANT`.
  - `reason` (string) — Reason for the current status. Enum: `ACCEPTED`, `APPROVED`, `MISSING_INFO`, `UNETHICAL`, `CREDIT`, `NOREACH`, `OTHER`, `TEST`, `UNIDENT`, `TIMEOUT`, `APPLICATION_REVOKED`, `SUSPICION`, `UNSPECIFIED`, `TECHNICAL_ERROR`, `FRAUD_BY_PARTNER`, `VOLUNTARY_BY_PARTNER`, `FRAUD_BY_KLARNA`, `VOLUNTARY_BY_KLARNA`.
  - `last_modified_at` (string)
  - `history[]` (array<object>) — Full status change history.
    - `to_status` (string) Enum: `PENDING`, `TRANSACTIONS_DISABLED`, `TRANSACTIONS_ENABLED`, `PAYOUTS_ENABLED`, `ADDITIONAL_REVIEW_1`, `ADDITIONAL_REVIEW_2`, `SUSPENDED`, `PRE_ASSESSMENT_PENDING`, `DORMANT`.
    - `reason` (string) Enum: `ACCEPTED`, `APPROVED`, `MISSING_INFO`, `UNETHICAL`, `CREDIT`, `NOREACH`, `OTHER`, `TEST`, `UNIDENT`, `TIMEOUT`, `APPLICATION_REVOKED`, `SUSPICION`, `UNSPECIFIED`, `TECHNICAL_ERROR`, `FRAUD_BY_PARTNER`, `VOLUNTARY_BY_PARTNER`, `FRAUD_BY_KLARNA`, `VOLUNTARY_BY_KLARNA`.
    - `modified_at` (string)

```json
{
  "merchant_id": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "type": "<string>",
  "country": "<string>",
  "business_information": {
    "organization_is_registered": false,
    "organization_entity_type": "<string>",
    "organization_name": "<string>",
    "organization_registration_id": "<string>",
    "organization_registration_authority": "<string>",
    "vat_id": "<string>",
    "subject_to_vat": false,
    "owner": {
      "id": 0,
      "given_name": "<string>",
      "family_name": "<string>",
      "personal_id": "<uuid>",
      "title": "<string>",
      "date_of_birth": "<string>",
      "street_address": "<string>",
      "street_address2": "<string>",
      "postal_code": "<string>",
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    },
    "owners": [
      {
        "id": 0,
        "given_name": "<string>",
        "family_name": "<string>",
        "personal_id": "<uuid>",
        "title": "<string>",
        "date_of_birth": "<string>",
        "street_address": "<string>",
        "street_address2": "<string>",
        "postal_code": "<string>",
        "city": "<string>",
        "region": "<string>",
        "country": "<string>"
      }
    ],
    "registered_address": {
      "street_address": "<string>",
      "street_address2": "<string>",
      "postal_code": "<string>",
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    },
    "operating_address": {
      "street_address": "<string>",
      "street_address2": "<string>",
      "postal_code": "<string>",
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  },
  "store_information": {
    "stores": [
      {
        "id": 0,
        "country": "<string>",
        "store_name": "<string>",
        "organization_category": "<string>",
        "homepage_url": "<string>",
        "logo_url": "<string>",
        "support_email": "<string>",
        "support_phone": "<string>"
      }
    ]
  },
  "platform": "<string>",
  "created_at": "<date-time>",
  "last_modified_at": "<date-time>",
  "transactions_requested_at": "<date-time>",
  "payouts_requested_at": "<date-time>",
  "price_plan": "<string>",
  "custom_data": {
    "key": "<string>"
  },
  "stakeholders": [
    {}
  ],
  "bank_accounts": [
    {
      "id": 0,
      "currency_code": "<string>",
      "country": "<string>",
      "account_type": "<string>",
      "account_holder": "<string>",
      "routing_number": "<string>",
      "account_number": "<string>",
      "is_default": false
    }
  ],
  "special_offer": {
    "id": "<string>",
    "valid_until": "<date-time>",
    "percentage_fee": 0,
    "fixed_fee": 0,
    "consumed": false
  },
  "settlement_schedule": {
    "delay": 0,
    "interval": "<string>",
    "day": "MONDAY"
  },
  "status": {
    "current": "PENDING",
    "reason": "ACCEPTED",
    "last_modified_at": "<date-time>",
    "history": [
      {
        "to_status": "PENDING",
        "reason": "ACCEPTED",
        "modified_at": "<date-time>"
      }
    ]
  }
}
```

### 401

Unauthorized — missing or invalid access token.

### 404

Merchant not found.