--- title: "Get DICT proxy claim" method: GET path: "/proxy_services/dict/proxy_claims/{id}" tags: ["DICT droxy claims"] --- # Get DICT proxy claim `GET /proxy_services/dict/proxy_claims/{id}` Retrieve a single DICT proxy claim by its ID. ## Path parameters - `id` string, uuid, required ## Response `200` Proxy claim retrieved successfully. - DictProxyClaim — A DICT proxy key portability or ownership claim. - `id` string, uuid, required — Unique identifier of the proxy claim. - `object` 'proxy_claim', required — Object type label. - `scheme` string, required — The directory scheme this claim belongs to. - `type` 'ownership' | 'portability', required — Claim type. - `role` 'claimer' | 'donor', required — Whether our customer is opening the claim (`claimer`) or receiving it (`donor`). - `status` 'pending_creation' | 'open' | 'creation_rejected' | 'pending_acknowledgment' | 'waiting_resolution' | 'acknowledgment_rejected' | 'pending_confirmation' | 'confirmed' | 'confirmation_rejected' | 'pending_cancellation' | 'cancelled' | 'cancellation_rejected' | 'pending_completion' | 'completed' | 'completion_rejected', required — Current state of the claim. - `pending_creation` — creation submitted to DICT; awaiting the scheme to finalise it (async). Flipped to `open` by `proxy_claim.creation_completed` or to `creation_rejected` by `proxy_claim.creation_rejected`. - `open` — DICT accepted the claim creation, awaiting donor response. - `creation_rejected` — DICT rejected the creation request (e.g. key not found or key type not claimable). - `pending_acknowledgment` — donor acknowledged the claim; awaiting the scheme to finalise it (async). Flipped to `waiting_resolution` by `proxy_claim.acknowledgment_completed`. - `waiting_resolution` — the donor's acknowledgment was finalised; waiting for the resolution period to complete. - `acknowledgment_rejected` — DICT rejected the donor's acknowledgment; `status_details` contains the rejection reason. - `pending_confirmation` — a confirm was requested; awaiting the scheme to finalise it (async). Flipped to `confirmed` by `proxy_claim.confirmation_completed`, which also releases the bound proxy key. - `confirmed` — donor confirmed the claim; the bound proxy key is released (`status = disabled`, `status_reason = released_via_claim`). - `confirmation_rejected` — DICT rejected the donor's confirmation; `status_details` contains the rejection reason. - `pending_cancellation` — a cancel was requested; awaiting the scheme to finalise it (async). Flipped to `cancelled` by `proxy_claim.cancellation_completed`. `scheme_data.cancel_reason` / `scheme_data.cancelled_by` are already populated. - `cancelled` — claim was cancelled; `scheme_data.cancel_reason` and `scheme_data.cancelled_by` are populated. - `cancellation_rejected` — DICT rejected the cancellation; `status_details` contains the rejection reason. - `pending_completion` — claimer requested completion; awaiting the scheme to finalise it (async). Flipped to `completed` by `proxy_claim.completion_completed`. - `completed` — claimer successfully completed the claim; `proxy_key_id` is populated with the new key. - `completion_rejected` — DICT rejected the completion request; `status_details` contains the rejection reason. - `status_details` string, nullable, required — Additional information about the current status, populated when the claim is rejected. - `proxy_type` 'phone' | 'email' | 'tax_id' | 'organisation' | 'random_alias', required — The category of the claimed proxy identifier. - `proxy_type_code` string, nullable, required — The scheme-specific sub-type code of the claimed proxy. - `proxy_identification` string, required — The proxy identifier value being claimed. - `claimer_name` string, required — Full name of the claimer. - `claimer_account_identification` string, required — Account number at the claiming institution. - `claimer_account_type` 'CACC' | 'SVGS' | 'SLRY' | 'TRAN' | 'null', nullable, required — ISO 20022 account type code at the claiming institution. - `claimer_account_issuer` string, nullable, required — Identifier of the institution that issued the claimer's account. - `claimer_servicer` string, required — ISPB of the claiming institution. - `donor_servicer` string, nullable, required — ISPB of the institution currently holding the key. Populated once DICT resolves the donor. - `connected_account_id` string, uuid, required — ID of the Mambu Payments connected account associated with this claim. - `internal_account_id` string, uuid, nullable, required — ID of the Mambu Payments internal account linked to this claim, if any. - `proxy_key_id` string, uuid, nullable, required — ID of the proxy key created upon successful completion of the claim. Null until the claim reaches `completed` status. - `resolution_period_end` string, date-time, nullable, required — Deadline by which the donor must respond. Null when `status` is `creation_rejected`. - `completion_period_end` string, date-time, nullable, required — Deadline by which the claim must reach a terminal state. Null when `status` is `creation_rejected`. - `scheme_data` DictProxyClaimSchemeData, required — DICT-specific output fields on a proxy claim. - `claim_id` string, nullable, required — BACEN claim ID returned by the DICT provider. Null when `status` is `creation_rejected`. - `claimer_tax_identification_number` string, required — Tax identification number (CPF or CNPJ) of the claimer. - `claimer_owner_type` 'individual' | 'legal_entity', required — Whether the claimer is an individual or a legal entity. - `claimer_opening_date` string, date-time, nullable, required — Date the claimer's account was opened at the claiming institution. - `confirm_reason` 'USER_REQUESTED' | 'ACCOUNT_CLOSURE' | 'DEFAULT_OPERATION' | 'null', nullable, required — Reason the claim was confirmed, if applicable. - `cancel_reason` string, nullable, required — Reason the claim was cancelled, if applicable. - `cancelled_by` string, nullable, required — Party that cancelled the claim (`claimer`, `donor`, or `dict`). - `last_modified` string, date-time, nullable, required — UTC timestamp of the last modification reported by DICT. - `metadata` object, required — Customer-defined key/value pairs. - `created_at` string, date-time, required — UTC timestamp when the claim was created. - `updated_at` string, date-time, nullable, required — UTC timestamp of the last status update. ## Other responses - `404` — The specified resource was not found. --- [API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/versions/220f101cc2ef/schema)