Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Keys

Get key

Searches for a DICT key entry returning the owner information.

post/v2/pix/keys/search

Headers

Authorizationstring required
Example:Bearer eyJhbGci...IUzUx

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

Request body

keystring required

Pix key value.

Example request

{
  "key": "email@email.com"
}

Response

OK

org_idstring

Organization ID

account_idinteger

Account ID

keystring required

Pix key value.

key_type'CPF' | 'CNPJ' | 'PHONE' | 'EMAIL' | 'EVP' required

User information that can be used to create a Pix key:

  • CPF - Cadastro de Pessoas Fisicas (Indiviual Taxpayer Registry) number. Similar to a Social Security number in the US.
  • CNPJ - Cadastro Nacional de Pessoa Juridica (National Registry of Legal Entities) number. Unique ID for legal entities, such as companies and organizations, in Brazil
  • EMAIL - Email
  • PHONE - Phone number
  • EVP - Endereco de pagamento virtual (virtual payment address). A randomly-generated UUID number.
creation_datetimestring date-time required

Creation datetime. A RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

ownership_datetimestring date-time

Ownership date time. A RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

correlation_idstring

The Correlation identifier field is used to link related API requests and events. The CID can help the Pismo engineering team track everything related to a call. If not passed, a random one is generated. You can find the CID in the response header.

claim_requested_datetimestring date-time

Claim requested date time. A RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

Example response

{
  "org_id": "TN-cc8f8b89-233a-4582-9f36-63ee85278d6d",
  "account_id": 6912345,
  "key": "email@email.com",
  "key_type": "EMAIL",
  "bank_account": {
    "participant": "00115678",
    "account_number": "98765432",
    "account_type": "TRAN",
    "branch": "011",
    "opening_datetime": "2020-08-13T13:49:03Z"
  },
  "owner": {
    "document_number": "7777888hh",
    "name": "Jerry Atrick",
    "type": "NATURAL_PERSON",
    "trade_name": "Acme Widgets"
  },
  "creation_datetime": "2020-08-13T13:49:03Z",
  "ownership_datetime": "2020-08-13T13:49:03Z",
  "correlation_id": "c737895c-8159-4c0c-a92a-a4f8600bff37",
  "claim_requested_datetime": "2020-08-13T13:49:03Z"
}