# Como buscar uma Assinatura usando a API?

> Para buscar uma assinatura usando a API, você deverá fazer uma chamada GET para o _endpoint_ `/api/v1/subscriptions/<globalID>` usando o `globalID` da assinatura.

Você pode acessar [aqui](/api#tag/subscription/GET/api/v1/subscriptions/{id}) a documentação referente a esse _endpoint_.

## Exemplo

Após efetuar a requisição, se tudo ocorreu bem, o _status code_ da requisição será `2xx` e no `body` da resposta, retornaremos a assinatura.

Retornarmeros a seguinte resposta de exemplo:

```json
{
  "subscription": {
    "globalID": "UGF5bWVudFN1YnNjcmlwdGlvbjo2M2UzYjJiNzczZDNkOTNiY2RkMzI5OTM=",
    "value": 100,
    "customer": {
      "name": "Dan",
      "email": "email0@example.com",
      "phone": "5511999999999",
      "taxID": {
        "taxID": "31324227036",
        "type": "BR:CPF"
      }
    }
  },
  "dayGenerateCharge": 5
}
```

### Exemplos em código

**Shell + cURL**

```sh
curl --request GET \
  --url https://api.woovi.com/api/v1/subscriptions/UGF5bWVudFN1YnNjcmlwdGlvbjo2M2UzYjJiNzczZDNkOTNiY2RkMzI5OTM= \
  --header 'Authorization: <AUTHORIZATION>'
```

**JavaScript + Fetch**

```js
fetch(
  'https://api.woovi.com/api/v1/subscriptions/UGF5bWVudFN1YnNjcmlwdGlvbjo2M2UzYjJiNzczZDNkOTNiY2RkMzI5OTM=',
  {
    headers: {
      Authorization: '<AUTHORIZATION>',
    },
  },
);
```