---
title: "Check DICT keys"
method: POST
path: "/v2/pix/keys/check"
tags: ["Keys"]
---

# Check DICT keys

`POST /v2/pix/keys/check`

## Request

- Base URL: `https://sandbox.pismolabs.io/pix-dict`
- URL: `https://sandbox.pismolabs.io/pix-dict/v2/pix/keys/check`
- Auth: HTTP bearer

Check that a list of key(s) exist in DICT, a Brazilian national Pix registery and database. Keys can be generated from an email address, a mobile phone number, a Tax ID number, or an EVP (virtual payment address).

## Headers

- `x-tenant` string, required
- `x-cid` string
- `x-account-id` string

## Request body

- EntryCheckRequest
  - `keys` EntryKey[]
    - `key` string, required

## Response `200`

CheckResponse Body

- EntryCheckResponse
  - `keys` EntryKeyResponse[]
    - `has_entry` boolean: Does key exist?
    - `key` string: Key value

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Resource Not Found
- `409`: Conflict
- `429`: Too many requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/pismo/apis/instant-payments-pix-management.md) - [All operations](https://skmtc.dev/pismo/apis/instant-payments-pix-management/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/instant-payments-pix-management/revisions/eb540c289547?raw)