---
title: "Query Submerchant"
method: POST
path: "/api/v1/submerchant/query"
tags: ["Sub Merchant Operations"]
---

# Query Submerchant

`POST /api/v1/submerchant/query`

You can query submerchant via this api

## Request body

- SubMerchantQueryRequest
  - `application_key` string, required — It is the key of your application on our environment
  - `external_id` string, required — Unique id of sub merchant in your system
  - `language` string — Its default value is tr. If you want to get messages in other languages, please send it. You can find supported languages in the api supported_languages.

## Response `200`

Successful Response

- SubMerchantResponse
  - `response_code` string
  - `message` string
  - `submerchant_id` string
  - `detail` SubMerchant
    - `submerchant_id` string
    - `external_id` string
    - `merchant_name` string
    - `name` string
    - `type` 'Individual' | 'PersonalCompany' | 'Company' — An enumeration.
    - `currency` string
    - `tax_number` string
    - `tax_office` string
    - `title` string
    - `email` string
    - `gsm_number` string
    - `contact_name` string
    - `contact_surname` string
    - `iban` string
    - `address` string
    - `city` string
    - `payment_due_day` integer
  - `externals` SubMerchantExternalInfo[]
    - `payment_org` string
    - `external_status` 'Active' | 'Waiting' | 'Cancelled' — An enumeration.
  - `service_error_code` string
  - `service_error_message` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/jetcheckout/apis/jet-checkout.md) · [All operations](https://skmtc.dev/jetcheckout/apis/jet-checkout/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jetcheckout/jet-checkout/revisions/b17a3806ccb0/schema)
