> ## Documentation Index
> Fetch the complete documentation index at: https://docs.escrybe.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido

> Envie sua primeira carta registrada em poucos minutos.

Este passo a passo cria uma **carta registrada** (`shipType=2`) e a acompanha.

## 1. Consulte seu saldo

```bash theme={null}
curl "https://app.escrybe.com.br/api/v2/balance/SEU_TOKEN"
```

```json Resposta theme={null}
{ "status": 200, "status_message": "Sucesso", "data": { "account_balance": 152.30, "total_val_pending_jobs": 4.10, "dif_account_balance": 148.20 } }
```

## 2. Valide antes de pagar (opcional)

Envie `test=1` para validar o payload e o PDF sem criar o pedido nem debitar
créditos.

```bash theme={null}
curl -X POST "https://app.escrybe.com.br/api/v2/post" \
  -F "userSecurityToken=SEU_TOKEN" \
  -F "shipType=2" \
  -F "test=1" \
  -F "name=Maria Silva" \
  -F "addr1=Rua das Flores" \
  -F "street_number=100" \
  -F "zip=01001000" \
  -F "city=São Paulo" \
  -F "state=SP" \
  -F "country=Brasil" \
  -F "pdfFile=@/caminho/para/carta.pdf"
```

## 3. Crie o pedido

Remova `test=1` para enviar de fato. O campo `data` retorna o **visual id** do
pedido — guarde-o.

```json Resposta theme={null}
{ "status": 200, "status_message": "Sucesso - pedido aceito", "data": "2607031" }
```

## 4. Acompanhe o pedido

```bash theme={null}
curl "https://app.escrybe.com.br/api/v2/get/SEU_TOKEN/2607031"
```

O campo `status` segue este ciclo de vida:

| Código | Significado            |
| ------ | ---------------------- |
| 0      | Processando            |
| 1      | Em produção            |
| 2      | Créditos insuficientes |
| 3      | Impresso               |
| 4      | Postado                |
| 5      | Cancelado              |
| 6      | Devolvido              |

<Tip>
  Quando `tracking` for preenchido, você pode acompanhar o código dos Correios
  e baixar o PDF enviado, a frente do envelope, o aviso de recebimento (AR) ou
  a via do remetente via
  [`/api/v2/download/{securityToken}/{job_id}/{type}`](/pt/produtos/cartas).
</Tip>