Domicílio

Pedir execução no Domicílio

POST/v1/cofre/certificados/{certificado_id}/execucoes

Execução no Domicílio Judicial Eletrônico, por certificado e sem processo. listar_comunicacoes não abre nenhuma comunicação e não registra ciência.

Parâmetros

Nome	Onde	Tipo	Obrigatório	Descrição
`certificado_id`	caminho	uuid	sim	Id do certificado
`Idempotency-Key`	cabeçalho	texto	sim	Chave única do pedido. Obrigatória

Corpo (`application/json`)

Campo	Tipo	Obrigatório	Descrição
`ate`	data (AAAA-MM-DD)	não	Comunicações até esta data
`ato`	`listar_comunicacoes` \| `baixar_peca` \| `verificar_domicilio`	não	`listar_comunicacoes` (padrão), `baixar_peca` ou `verificar_domicilio` (padrão `listar_comunicacoes`)
`ciente`	`A` \| `N` \| `L`	não	Filtro de ciência: `A`, `N` ou `L`
`cnpj`	texto	não	CNPJ do perfil. Obrigatório em `listar_comunicacoes`
`desde`	data (AAAA-MM-DD)	não	Comunicações a partir desta data
`id_comunicacao`	texto	não	Comunicação da peça. Obrigatório em `baixar_peca`

Respostas

HTTP	Significa
202	Aceito: entrou na fila
422	Corpo ou parâmetros com formato inválido (`detail` lista os campos)

Exemplo de resposta

{
  "id": "c3f0a9d2-7b1e-4f6a-8c2d-5e9b1a0f3d47",
  "processo": null,
  "tribunal": "0.00",
  "sistema": "DOMICILIO",
  "ato": "listar_comunicacoes",
  "estado": "na_fila",
  "desfecho": null,
  "pendencia": null,
  "criada_em": "2026-09-26T12:00:00+00:00",
  "concluida_em": null,
  "documentos": []
}

Erros

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

HTTP	`erro`	Significa
401	—	Chave ausente ou inválida
422	`idempotency_key_obrigatoria`	Envie o cabeçalho Idempotency-Key
422	`cnpj_obrigatorio`	Informe o CNPJ do perfil
422	`id_comunicacao_obrigatorio`	Informe `id_comunicacao` para baixar a peça
404	`nao_encontrado`	A Conexão não existe nesta Conta (ou foi revogada)
409	`limite_mensal_atingido`	A Conta chegou ao limite mensal de consumo do contrato