# Ver execução

`GET /v1/execucoes/{execucao_id}`

Estado, desfecho, pendência, dados e documentos da execução. Consulte a cada 15–30 s até o `estado` sair de `na_fila`/`em_andamento`.

## Parâmetros

| Nome | Onde | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
| `execucao_id` | caminho | uuid | sim | Id da execução |

## Respostas

| HTTP | Significa |
|---|---|
| 200 | OK |
| 422 | Corpo ou parâmetros com formato inválido (`detail` lista os campos) |

### Exemplo de resposta

```json
{
  "id": "c3f0a9d2-7b1e-4f6a-8c2d-5e9b1a0f3d47",
  "processo": "8187736-02.2026.8.05.0001",
  "tribunal": "8.05",
  "sistema": "PJE",
  "ato": "copia_integral",
  "estado": "concluida",
  "desfecho": null,
  "pendencia": null,
  "criada_em": "2026-09-26T12:00:00+00:00",
  "concluida_em": "2026-09-26T12:03:41+00:00",
  "documentos": [
    {
      "id": "9a7c1e44-2b3d-4f5e-8a6b-0c1d2e3f4a5b",
      "nome": "copia-integral.pdf",
      "tamanho_bytes": 4812345
    }
  ],
  "dados": {
    "capa": {
      "classe": "Procedimento Comum Cível"
    },
    "envolvidos": [],
    "movimentacoes": []
  }
}
```

## Erros

Recusas vêm como `{"detail": {"erro": "<código>", "mensagem": "…"}}`.

| HTTP | `erro` | Significa |
|---|---|---|
| 401 | — | Chave ausente ou inválida |
| 404 | `nao_encontrado` | A execução não existe nesta Conta |

## Exemplos de requisição

### Bash

```bash
curl 'https://sync.lops.com.br/v1/execucoes/c3f0a9d2-7b1e-4f6a-8c2d-5e9b1a0f3d47' \
  -H "Authorization: Bearer $SYNC_CHAVE"
```

### JavaScript

```javascript
const resposta = await fetch("https://sync.lops.com.br/v1/execucoes/c3f0a9d2-7b1e-4f6a-8c2d-5e9b1a0f3d47", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.SYNC_CHAVE}`,
  },
});
console.log(resposta.status, await resposta.json());
```

### Python

```python
import os

import requests

resposta = requests.get(
    "https://sync.lops.com.br/v1/execucoes/c3f0a9d2-7b1e-4f6a-8c2d-5e9b1a0f3d47",
    headers={"Authorization": f"Bearer {os.environ['SYNC_CHAVE']}"},
)
print(resposta.status_code, resposta.json())
```

### PHP

```php
<?php
$ch = curl_init('https://sync.lops.com.br/v1/execucoes/c3f0a9d2-7b1e-4f6a-8c2d-5e9b1a0f3d47');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SYNC_CHAVE'),
    ],
]);
$corpo = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
var_dump($status, json_decode($corpo, true));
```