# Buscar Terminais pelo Número de Série

### **Buscando pelo número de série**

Para buscar terminais pelo número de série, realize a consulta via `GET` na rota **Url**/segments/{segmentId}/devices/serial/{serial}.

O **SegmentID** deverá ser informado, saiba mais em [Login via API](https://guide.posfacil.com.br/autenticacao/login-api). O uso de seu [**Bearer Token**](https://guide.posfacil.com.br/configuracoes/bearer-token) também será necessário.

## Buscar Terminal por Número de Série

<mark style="color:blue;">`GET`</mark> `{Url}/segments/{segmentId}/devices/serial/{serial}`

#### Path Parameters

| Name                                        | Type   | Description                 |
| ------------------------------------------- | ------ | --------------------------- |
| segmentId<mark style="color:red;">\*</mark> | string | ID de Segmento              |
| serial<mark style="color:red;">\*</mark>    | string | Número de série do terminal |

{% tabs %}
{% tab title="200 OK" %}

```
[
    {
        "_id": "string",
        "createdAt": "2020-01-01T00:00:00Z",
        "updatedAt": "2020-01-01T00:00:00Z",
        "installationId": "string",
        "manufacturer": "string",
        "deviceModel": "string",
        "serial": "string",
        "acquirer": "string",
        "os": "string",
        "systemVersion": "string",
        "appVersion": "string",
        "status": "active",
        "lastSigninAt": { },
        "lastSigninBy": "string",
        "createdBy": "string"
    }
]
```

{% endtab %}

{% tab title="401 Verifique o Bearer Token utilizado e tente novamente." %}

```
[]
```

{% endtab %}

{% tab title="404 Verifique a rota e método utilizado e tente novamente." %}

```
[]
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
Caso a requisição esteja correta, o código **`200 OK`** será retornado.\
\
Prossiga para as próximas sessões para entender mais sobre nossas funções disponíveis.
{% endhint %}

{% hint style="danger" %}
**Outros Erros:**\
Caso sejam retornados outros erros, favor entrar em contato com o time de integração.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.posfacil.com.br/terminais/listar-terminais-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.