> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ops-apidoc.hugin.co/llms.txt.
> For full documentation content, see https://ops-apidoc.hugin.co/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ops-apidoc.hugin.co/_mcp/server.

# Get Merchant

GET https://ops.hugin.co/api/v1/merchants/{taxId}

Get Merchant - Firma Bilgisi Sorgulama

VKN veya TCKN ile firma bilgilerini ve bağlı cihazları getirir.


Reference: https://ops-apidoc.hugin.co/hugin-ops-api/merchants/get-merchant

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: HuginOps API
  version: 1.0.0
paths:
  /api/v1/merchants/{taxId}:
    get:
      operationId: get-merchant
      summary: Get Merchant
      description: |
        Get Merchant - Firma Bilgisi Sorgulama

        VKN veya TCKN ile firma bilgilerini ve bağlı cihazları getirir.
      tags:
        - subpackage_merchants
      parameters:
        - name: taxId
          in: path
          description: >-
            Vergi kimlik numarası (10 haneli) veya TC kimlik numarası (11
            haneli).
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Merchants_Get Merchant_Response_200'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/GetApiV1MerchantsTaxidRequestUnauthorizedError
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/GetApiV1MerchantsTaxidRequestNotFoundError
servers:
  - url: https://ops.hugin.co
    description: https://ops.hugin.co
components:
  schemas:
    ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaDataAddress:
      type: object
      properties:
        street:
          type: string
        district:
          type: string
        county:
          type: string
        postCode:
          type: string
        cityCode:
          type: string
      required:
        - street
        - district
        - county
        - postCode
        - cityCode
      title: ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaDataAddress
    ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaDataDevicesItems:
      type: object
      properties:
        deviceId:
          type: string
        fiscalId:
          type: string
        serialNo:
          type: string
        brand:
          type: string
        model:
          type: string
        status:
          type: string
        merchantId:
          type: string
        terminalIds:
          type: array
          items:
            type: string
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - deviceId
        - fiscalId
        - serialNo
        - brand
        - model
        - status
        - merchantId
        - terminalIds
        - createdAt
        - updatedAt
      title: >-
        ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaDataDevicesItems
    ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaData:
      type: object
      properties:
        merchantId:
          type: string
        companyName:
          type: string
        companyKnownAs:
          type: string
        vkn:
          type: string
        tckn:
          type: string
        taxOfficeName:
          type: string
        email:
          type: string
          format: email
        phone:
          type: string
        address:
          $ref: >-
            #/components/schemas/ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaDataAddress
        devices:
          type: array
          items:
            $ref: >-
              #/components/schemas/ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaDataDevicesItems
      required:
        - merchantId
        - companyName
        - companyKnownAs
        - vkn
        - tckn
        - taxOfficeName
        - email
        - phone
        - address
        - devices
      title: ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaData
    Merchants_Get Merchant_Response_200:
      type: object
      properties:
        success:
          type: boolean
        data:
          $ref: >-
            #/components/schemas/ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaData
      required:
        - success
        - data
      title: Merchants_Get Merchant_Response_200
    ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      title: ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaError
    GetApiV1MerchantsTaxidRequestUnauthorizedError:
      type: object
      properties:
        success:
          type: boolean
        error:
          $ref: >-
            #/components/schemas/ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaError
      required:
        - success
        - error
      title: GetApiV1MerchantsTaxidRequestUnauthorizedError
    GetApiV1MerchantsTaxidRequestNotFoundError:
      type: object
      properties:
        success:
          type: boolean
        error:
          $ref: >-
            #/components/schemas/ApiV1MerchantsTaxIdGetResponsesContentApplicationJsonSchemaError
      required:
        - success
        - error
      title: GetApiV1MerchantsTaxidRequestNotFoundError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

```

## Examples

### Merchant details retrieved successfully



**Request**

```json
{}
```

**Response**

```json
{
  "success": true,
  "data": {
    "merchantId": "MRC123456789",
    "companyName": "Tekno Yazılım ve Danışmanlık A.Ş.",
    "companyKnownAs": "Tekno Yazılım",
    "vkn": "0080792700",
    "tckn": "",
    "taxOfficeName": "Kadıköy Vergi Dairesi",
    "email": "info@teknoyazilim.com.tr",
    "phone": "+90 216 123 45 67",
    "address": {
      "street": "Bağdat Caddesi No:123",
      "district": "Kadıköy",
      "county": "İstanbul",
      "postCode": "34710",
      "cityCode": "34"
    },
    "devices": [
      {
        "deviceId": "DEV202304001",
        "fiscalId": "F00807927001",
        "serialNo": "SN1234567890",
        "brand": "Verifone",
        "model": "VX520",
        "status": "active",
        "merchantId": "MRC123456789",
        "terminalIds": [
          "TERM1001",
          "TERM1002"
        ],
        "createdAt": "2022-05-15T09:30:00Z",
        "updatedAt": "2024-04-01T14:45:00Z"
      },
      {
        "deviceId": "DEV202304002",
        "fiscalId": "F00807927002",
        "serialNo": "SN0987654321",
        "brand": "Ingenico",
        "model": "iCT220",
        "status": "inactive",
        "merchantId": "MRC123456789",
        "terminalIds": [
          "TERM2001",
          "TERM2002"
        ],
        "createdAt": "2021-11-20T11:00:00Z",
        "updatedAt": "2023-12-15T16:20:00Z"
      }
    ]
  }
}
```

**SDK Code**

```python Merchant details retrieved successfully
import requests

url = "https://ops.hugin.co/api/v1/merchants/0080792700"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.get(url, json=payload, headers=headers)

print(response.json())
```

```javascript Merchant details retrieved successfully
const url = 'https://ops.hugin.co/api/v1/merchants/0080792700';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Merchant details retrieved successfully
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ops.hugin.co/api/v1/merchants/0080792700"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Merchant details retrieved successfully
require 'uri'
require 'net/http'

url = URI("https://ops.hugin.co/api/v1/merchants/0080792700")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body
```

```java Merchant details retrieved successfully
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://ops.hugin.co/api/v1/merchants/0080792700")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

```php Merchant details retrieved successfully
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://ops.hugin.co/api/v1/merchants/0080792700', [
  'body' => '{}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Merchant details retrieved successfully
using RestSharp;

var client = new RestClient("https://ops.hugin.co/api/v1/merchants/0080792700");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Merchant details retrieved successfully
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://ops.hugin.co/api/v1/merchants/0080792700")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Generic error response.



**Request**

```json
{}
```

**Response**

```json
{
  "success": true,
  "data": {
    "merchantId": "MRC123456789",
    "companyName": "Tekno Yazılım ve Danışmanlık A.Ş.",
    "companyKnownAs": "Tekno Yazılım",
    "vkn": "0080792700",
    "tckn": "",
    "taxOfficeName": "Kadıköy Vergi Dairesi",
    "email": "info@teknoyazilim.com.tr",
    "phone": "+90 216 123 45 67",
    "address": {
      "street": "Bağdat Caddesi No:123",
      "district": "Kadıköy",
      "county": "İstanbul",
      "postCode": "34710",
      "cityCode": "34"
    },
    "devices": [
      {
        "deviceId": "DEV202304001",
        "fiscalId": "F00807927001",
        "serialNo": "SN1234567890",
        "brand": "Verifone",
        "model": "VX520",
        "status": "active",
        "merchantId": "MRC123456789",
        "terminalIds": [
          "TERM1001",
          "TERM1002"
        ],
        "createdAt": "2022-05-15T09:30:00Z",
        "updatedAt": "2024-04-01T14:45:00Z"
      },
      {
        "deviceId": "DEV202304002",
        "fiscalId": "F00807927002",
        "serialNo": "SN0987654321",
        "brand": "Ingenico",
        "model": "iCT220",
        "status": "inactive",
        "merchantId": "MRC123456789",
        "terminalIds": [
          "TERM2001",
          "TERM2002"
        ],
        "createdAt": "2021-11-20T11:00:00Z",
        "updatedAt": "2023-12-15T16:20:00Z"
      }
    ]
  }
}
```

**SDK Code**

```python Generic error response.
import requests

url = "https://ops.hugin.co/api/v1/merchants/0080792700"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.get(url, json=payload, headers=headers)

print(response.json())
```

```javascript Generic error response.
const url = 'https://ops.hugin.co/api/v1/merchants/0080792700';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Generic error response.
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ops.hugin.co/api/v1/merchants/0080792700"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Generic error response.
require 'uri'
require 'net/http'

url = URI("https://ops.hugin.co/api/v1/merchants/0080792700")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body
```

```java Generic error response.
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://ops.hugin.co/api/v1/merchants/0080792700")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

```php Generic error response.
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://ops.hugin.co/api/v1/merchants/0080792700', [
  'body' => '{}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Generic error response.
using RestSharp;

var client = new RestClient("https://ops.hugin.co/api/v1/merchants/0080792700");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Generic error response.
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://ops.hugin.co/api/v1/merchants/0080792700")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```