---
title: "List DICT proxy claims"
method: GET
path: "/proxy_services/dict/proxy_claims"
tags: ["DICT proxy claims"]
---

# List DICT proxy claims

`GET /proxy_services/dict/proxy_claims`

Returns proxy claims for the authenticated legal entity, with cursor
pagination (`limit`, `starting_after`) and optional filters (`status`,
`connected_account_id`, `type`, `role`, `proxy_type_code`,
`proxy_identification`, `internal_account_id`, `proxy_key_id`).
Records are ordered by `created_at` descending, then `id` descending.
To page forward, pass the last record's `id` as `starting_after` on
the next request.

## Query parameters

- `limit` integer
- `starting_after` string, uuid
- `status` 'pending_creation' | 'open' | 'creation_rejected'
- `connected_account_id` string, uuid
- `type` 'ownership' | 'portability'
- `role` 'claimer' | 'donor'
- `proxy_type_code` 'cpf' | 'cnpj' | 'abn' | 'teli' | 'emal' | 'aubn' | 'orgn' | 'evp'
- `proxy_identification` string
- `internal_account_id` string, uuid
- `proxy_key_id` string, uuid

## Response `200`

List of filtered proxy claims.

- DictProxyClaimListResult — List response for DICT proxy claims. `records` is the page of results, ordered by `created_at` then `id` descending. To page forward, pass the last record's `id` as `starting_after` on the next request.
  - `records` DictProxyClaim[], required — List of proxy claims matching the query.
    - `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

- `400` — Validation error.

---

[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)