> This page is for Internet banking (beta).

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# Cadastro do titular

O endereço da conta é o endereço do titular no liquidante. Pessoa física
altera na hora. Pessoa jurídica abre um pedido e a mesa só grava depois
do comprovante.

## Ler

`GET /v1/accounts/{accountId}/holder` devolve nome, documento e endereço
ao vivo. A resposta leva `Cache-Control: no-store`. Escopo `holder.read`.

## Pessoa física

`PUT /v1/accounts/{accountId}/holder/address` só quando o documento da
conta é CPF e `X-Acting-Document` é esse mesmo CPF. O `cityIbgeCode` tem
de bater com a UF. Não move dinheiro e não pede `Idempotency-Key`.

Conta PJ nesta rota responde **422** `holder_update_required`.

## Pessoa jurídica

`POST /v1/accounts/{accountId}/holder-updates` com `Idempotency-Key`.

| `kind`         | documento obrigatório                                                |
| -------------- | -------------------------------------------------------------------- |
| `address`      | `company_proof_of_address`                                           |
| `registration` | `company_articles` (CNPJ, documento do sócio e outros são opcionais) |

O arquivo sobe pela URL assinada (`evidence/upload-url` e `evidence/add`),
PDF, JPEG ou PNG até 5 MB. `submit` só conta arquivo com `scanStatus`
`APPROVED`. Aprovar um pedido de endereço é o que chama o liquidante; se
o liquidante recusar, o pedido continua em análise.

Pedido parado em documento por 7 dias é cancelado (`holder_update.updated`
com `reason=expired`).

O webhook não traz o endereço. Leia de novo o `GET`.