---
title: "Search POS by serial number"
method: GET
path: "/v1/pos"
tags: ["POS"]
---

# Search POS by serial number

`GET /v1/pos`

Retrieves POS details based on the provided serial number. This endpoint allows users to search for a POS by its unique serial number and returns relevant information, including status, model, and registration details

## Query parameters

- `serial_number` string, required

## Response `200`

The record has been successfully getted

- GetPosSearchDto
  - `id` string, required — POS id
  - `code` string, required — POS code
  - `status` string, required — Status
  - `serial_number` string, required — POS serial number
  - `terminal_model` string, required — POS model
  - `manufacturer` string, required — POS manufacturer
  - `seller_id` string, required — Active POS for seller_id
  - `pin_capability` string, required — Shows that the POS is ready for use
  - `contactless_enabled` boolean, required — Shows that the POS is ready for contactless payment
  - `metadata` object, required — Metadata

## Other responses

- `400` — Client specified an invalid argument, request body or query param
- `401` — The user is unauthorized
- `403` — Authenticated user is not allowed to access this resource
- `404` — The resource was not found
- `408` — Request timeout
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/edubank/apis/api-edubank.md) · [All operations](https://skmtc.dev/edubank/apis/api-edubank/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edubank/api-edubank/revisions/dce4008191d4/schema)