> 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://en.docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://en.docs.api.corpx.com/_mcp/server.

# Account-holder locks

The account owner can, in internet banking, block outgoing payments, limit
the hours and restrict source IPs. Those rules apply to **your** API the
same way they apply to the UI. You read what is in force; the holder is
who tightens or loosens the lock.

## What the API returns when a lock blocks a payment

| Code                            | HTTP | Meaning                                                            |
| ------------------------------- | ---- | ------------------------------------------------------------------ |
| `cashout_locked`                | 423  | Outgoing payments blocked                                          |
| `cashout_outside_hours`         | 403  | Outside the window (Brasília time, unless another timezone is set) |
| `cashout_source_ip_not_allowed` | 403  | **This** call’s IP is not on the holder’s list                     |

That is not a signing failure. Tell the holder or wait for the window.
The **credential** IP allowlist (`ip_not_allowed` at the edge) is a
different list — see [Keys and IPs](/ib/guias/autenticacao/chaves-e-ips).

## Read the locks

`GET /v1/accounts/{accountId}/security/locks` (read scope):

```json
{
  "accountId": "6ff57bc1-e4a9-403b-be62-42378b8aafd7",
  "current": {
    "cashoutBlocked": false,
    "cashoutHours": { "start": "08:00", "end": "18:00", "timezone": "America/Sao_Paulo" },
    "cashoutSourceIps": ["200.10.20.30/32"]
  },
  "pending": null,
  "pendingEffectiveAt": null
}
```

If the holder asked for a loosening (unblock, widen the window, add an
IP), the change waits **6 hours** and appears in `pending` +
`pendingEffectiveAt`. Until then the stricter `current` applies.

There is no `PUT` on these routes for this credential. Trying returns 403.

## Limits

The read, the increase request and the per-operator ceiling are in the
[limits guide](/ib/guias/conta/limites). Hours and IP locks stay on this
page.

## Operator PIN

The PIN exists for the bank **UI** (the holder’s credential). Your
credential does not send `X-Transaction-Pin`. Routes that set, verify or
reset a PIN (`/security/pin`) return 403 for this audience.

## Who else operates the same account

`GET /v1/accounts/{accountId}/shared-access` lists other access to the
same bank account: display name, state and since when. No credentials,
balance or configuration of the others — only what the holder already
sees in internet banking.