Create proxy claim

post

https://sandbox.numeral.io/v1/proxy_services/dict/proxy_claims

Open a portability or ownership claim for a DICT proxy key registered at another institution.

Portability — the same person moves the key to a new institution. The claimer's tax ID must match the donor's.
Ownership — a new person claims a key (e.g. a reassigned phone number). Tax IDs do not need to match.

EVP (random alias) keys cannot be claimed and will result in a creation_rejected response.

If an active claim already exists for the proxy_identification, the request returns 409.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Details required to open a DICT proxy key portability or ownership claim.

type

string

enum

required

Whether the claim transfers the key to a new owner (ownership) or to the same owner at a new institution (portability).

Allowed:

proxy_type

string

enum

required

The category of proxy identifier being claimed.

Allowed:

proxy_type_code

string

enum

The scheme-specific sub-type code for the proxy. Required when proxy_type is tax_id.

proxy_identification

string

required

The proxy identifier value to claim (e.g. CPF number, phone number).

claimer_name

string

required

length ≤ 140

Full name of the claimer. Maximum 140 characters.

claimer_account_identification

string

required

Account number at the claiming institution.

claimer_account_type

string

enum

ISO 20022 account type code at the claiming institution.

Allowed:

claimer_account_issuer

string

Identifier of the institution that issued the claimer's account (e.g. branch code for DICT).

claimer_servicer

string

required

ISPB of the claiming institution.

connected_account_id

uuid

required

ID of the Mambu Payments connected account associated with this claim.

internal_account_id

uuid

Optional ID of an internal account in Mambu Payments linked to this claim.

scheme_data

object

required

DICT-specific fields required to open a proxy claim.

metadata

object

Customer-defined key/value pairs passed through as-is.

Responses

404

No proxy configuration found for this legal entity and the DICT scheme.

201Proxy claim created. status is open when DICT accepted the claim, or creation_rejected when DICT rejected it (e.g. key not found or not claimable).

400Validation error.

409Conflict.