# Consultar enrollment

> Devolve um enrollment da sua empresa pelo id, com o status de cada produto.

Página: https://doc.rapidchargeback.com/canais/enrollments/consultar-enrollment/

Devolve um enrollment da sua empresa pelo id, com o status de cada produto. O id é o que [Pedir enrollment](https://doc.rapidchargeback.com/canais/enrollments/pedir-enrollment/) devolve e o `merchant_enrollment_id` dos alertas.

## Endpoint

```
GET https://api.rapidchargeback.com/api/v1/enrollments/:enrollment_id
```

## Autenticação

```
Authorization: Basic base64(client_id:client_secret)
```

---

## Parâmetros de URL

| Param | Tipo | Descrição |
|---|---|---|
| `enrollment_id` | string (UUID) | O `id` do enrollment |

Esta rota não aceita query params: qualquer parâmetro na URL é recusado com `422 VALIDATION_ERROR` (`Unknown field: <nome>`).

---

## Exemplo de requisição

```bash
curl https://api.rapidchargeback.com/api/v1/enrollments/00000000-0000-0000-0000-0000000000aa \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

---

## Resposta

### Sucesso

```
HTTP/1.1 200 OK
```

```json
{
  "data": {
    "id": "00000000-0000-0000-0000-0000000000aa",
    "merchant_id": "00000000-0000-0000-0000-000000000001",
    "merchant_ref": "PB-1001",
    "enrollment_type": "descriptor",
    "descriptor_value": "loja exemplo",
    "descriptor_rule": "exact",
    "bin": null,
    "caid": null,
    "arn": null,
    "products": {
      "alert": { "status": "rejected", "rejection_reason": "Descriptor não encontrado nas transações da loja", "approved_at": null },
      "prevention": null
    },
    "created_at": "2026-11-06T12:00:00.000Z",
    "updated_at": "2026-11-07T15:00:00.000Z"
  }
}
```

Os campos estão em [Pedir enrollment](https://doc.rapidchargeback.com/canais/enrollments/pedir-enrollment/#criado) e os status em [Status de cada produto](https://doc.rapidchargeback.com/canais/enrollments/visao-geral/#status-de-cada-produto).

### Enrollment não encontrado

```
HTTP/1.1 404 Not Found
```

```json
{
  "error": {
    "code": "ENROLLMENT_NOT_FOUND",
    "message": "Enrollment not found"
  }
}
```

O mesmo `404` vale para um id que não existe, que é de outra empresa ou que não é um UUID.

---

## Notas

- **Auth, rate limit, códigos de erro:** ver [Autenticação](https://doc.rapidchargeback.com/referencia/autenticacao/) e [Códigos de resposta](https://doc.rapidchargeback.com/referencia/codigos-de-resposta/).
