> For the complete documentation index, see [llms.txt](https://apidocs.cloudinvoice.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.cloudinvoice.net/documentacao-api/documentos/exists.md).

# Exists

Indica, caso exista, o ID do documento a partir do seu identificador ou referência.

## Verificar Existência de Documento

{% hint style="warning" %}
Os identificadores dos documentos CloudInvoice, normalmente com aspeto semelhante a `FAC A01/1`, contêm sempre uma barra `/` . Caracteres especiais como este deverão ser sempre codificados para URL  `/  → %2F` .
{% endhint %}

<mark style="color:blue;">`GET`</mark> `https://api.cloudinvoice.net/documents/exists/:search/`

#### Path Parameters

| Name                                     | Type   | Description                                      |
| ---------------------------------------- | ------ | ------------------------------------------------ |
| search<mark style="color:red;">\*</mark> | string | Identificador/Referência do Documento a procurar |

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl https://api.cloudinvoice.net/documents/exists/FAC%20A01%2F1/
    -H "Content-Type: application/json"
```

{% endtab %}

{% tab title="Exemplo de Resposta" %}

```json
{
    "exists": true,
    "id": 1,
}
```

{% endtab %}
{% endtabs %}

Para ver exemplos de pedidos nas várias linguagens, consulte a página[ Exemplos de Pedidos.](/introducao/exemplos-de-pedidos.md)