> For the complete documentation index, see [llms.txt](https://vaccinecard.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vaccinecard.gitbook.io/docs/localizacao.md).

# Localização

Este capitulo retorna os países e seus estados

{% code title="Endpoint principal para receber informações da localização" %}

```http
https://vaccine-card.herokuapp.com/api/location/
```

{% endcode %}

{% hint style="info" %}
**Não precisa estar autenticado para usar essa parte**
{% endhint %}

### Pegando todos os países

## países

<mark style="color:blue;">`GET`</mark> `https://vaccine-card.herokuapp.com/api/locations/countries/`

Recebi um json com todos os países registrados.

{% tabs %}
{% tab title="200 Recebidos todos os países" %}

```javascript
{
    "countries": [
        {
            ...
        },
        ...
    ]
}
```

{% endtab %}
{% endtabs %}

### Estados (Províncias)

## estados

<mark style="color:blue;">`GET`</mark> `https://vaccine-card.herokuapp.com/api/locations/countries/{id}/states`

Retorna todas os estados do país **{id}**

#### Path Parameters

| Name | Type    | Description |
| ---- | ------- | ----------- |
| id   | integer | ID do país  |

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

```javascript
{
    "states": [
        { 
            ...
        },
        ...
    ]
}
```

{% endtab %}
{% endtabs %}