---
title: "Find by item"
method: GET
path: "/identity"
tags: ["Identity"]
---

# Find by item

`GET /identity`

Recovers identity of an item if available

## Query parameters

- `itemId` string, uuid, required

## Response `200`

Retrieve an identity by itemId

- IdentityResponse — Response with details personal information related to the owner of the connection's account
  - `id` string, required — The ID of the identity to retrieve
  - `itemId` string, uuid, required — Identifier of the item linked to the identity
  - `birthDate` string, date-time — Date of birth
  - `taxNumber` string — The tax ID (CNPJ) associated with the business account
  - `document` string — Primary document that identifies the owner
  - `documentType` string — Type of document collected
  - `jobTitle` string — Profession or Job information
  - `fullName` string — Name of the owner of the account
  - `establishmentCode` string — Establishment code (only for PAYMENT_ACCOUNT connectors)
  - `establishmentName` string — Name of the establishment (only for PAYMENT_ACCOUNT connectors)
  - `companyName` string — For business connector, the name of the business
  - `phoneNumbers` PhoneNumber[] — List of phone numbers related to the account
    - `type` 'Personal' | 'Work' | 'Residencial' — Type of phone number: personal, work or residencial
    - `value` string, required — The complete phone number
    - `countryCallingCode` string — International dialing code (DDI). Populated when different from '55'
    - `areaCode` string — Area code (DDD) of the client's phone
    - `extension` string — Extension number, when part of the phone identification
    - `additionalInfo` string — Additional info related to the source phone type. Populated when the source type at the institution does not fit the standard categories
  - `emails` Email[] — List of email addresses related to the account
    - `type` 'Personal' | 'Work'
    - `value` string, required — The full email of the person.
  - `addresses` Address[] — List of addresses related to the account
    - `fullAddress` string — Full address using all components available
    - `primaryAddress` string — Primary address, stret name and street number
    - `city` string — The complete city name
    - `postalCode` string — The Zip code
    - `state` string — The state or province
    - `country` string — The complete country name (free text)
    - `type` 'Personal' | 'Work' — Type of address, Personal or Work
    - `additionalInfo` string — Additional address information such as apartment number, complement, or other details
    - `district` string — District / neighborhood (bairro) — a community or region within a city or municipality based on geographic subdivisions
    - `ibgeTownCode` string — IBGE municipality code (7 digits). The IBGE table associates each Brazilian municipality with a 7-digit code; the first two digits identify the Federation Unit
    - `countryCode` string — Country code in alpha3 ISO-3166 format (e.g. 'BRA')
    - `geographicCoordinates` GeographicCoordinates — Geographic coordinates in decimal degrees, WGS84 reference system
      - `latitude` number, required — Latitude. Between -90 and 90 (e.g. -23.5475)
      - `longitude` number, required — Longitude. Between -180 and 180 (e.g. -46.6361)
  - `relations` IdentityRelation[] — List of names related to the account
    - `type` 'Mother' | 'Father' | 'Spouse' — Type of relation: Father, Mother or Spouse
    - `name` string — The full name of the person
    - `document` string — Primary document of the person
  - `investorProfile` 'Conservative' | 'Moderate' | 'Aggressive' — Is a rating that indicates the investor personality and motivation for investing
  - `qualifications` object — Information that allows understanding since when the consulted person has been a client of the institution, as well as an indicator of the products and services they currently consume and their representatives
    - `companyCnpj` string, required — CNPJ of the company
    - `occupationCode` 'RECEITA_FEDERAL' | 'CBO' | 'OUTRO' — Occupation code
    - `occupationDescription` string — Free-text occupation description. When occupationCode is RECEITA_FEDERAL or CBO it holds the standardized list code; when OUTRO it describes the occupation in cases where the institution does not follow the Receita Federal nor the CBO list
    - `informedIncome` object — Informed income
      - `frequency` 'DIARIA' | 'SEMANAL' | 'QUINZENAL' | 'MENSAL' | 'BIMESTRAL' | 'TRIMESTRAL' | 'SEMESTRAL' | 'ANUAL' | 'OUTROS', required — Frequency of the informed income
      - `amount` number, required — Amount of the informed income
      - `date` string, date-time, required — Date when the income was informed
    - `informedPatrimony` object — Informed patrimony
      - `amount` number, required — Amount of the informed patrimony
      - `year` number, required — Year of the patrimony
      - `date` string, date-time — Reference date of the patrimony. Returned on the business path of Open Finance, where the source field is a full date rather than just a year
    - `economicActivities` EconomicActivity[] — List of CNAE codes describing the economic activities of the business (Brazilian National Classification of Economic Activities). Only one entry per response should be marked as main
      - `code` string, required — CNAE code (7 digits, including leading zeros). Follows the CNAE-Subclasse 2.3 classification
      - `isMain` boolean, required — Whether this is the main economic activity (true) or a secondary one (false). Only one item per response should be true
    - `informedRevenue` InformedRevenue — Revenue (faturamento) informed by the business — the business equivalent of informedIncome
      - `amount` number, required — Amount of the informed revenue
      - `frequency` 'DAILY' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'BIMONTHLY' | 'QUARTERLY' | 'SEMIANNUAL' | 'ANNUAL' | 'OTHER' — Frequency or period of the informed revenue
      - `frequencyAdditionalInfo` string — Free-text complement to the frequency. Populated when frequency is OTHER
      - `year` number — Reference year of the revenue
  - `financialRelationships` object — Information that allows institutions to assess, evaluate, characterize, and classify the client with the purpose of understanding their risk profile and their economic-financial capacity
    - `startDate` string, date-time, required — Date when the relationship with the institution started
    - `productsServicesType` string[], required — List of products and services that the client consumes
    - `productsServicesTypeAdditionalInfo` string — Additional info about the products and services. Populated when productsServicesType includes 'OUTROS'
    - `procurators` object[], required — List of procurators of the client
      - `type` 'REPRESENTANTE_LEGAL' | 'PROCURADOR', required — Type of relationship with the client. Legal representative — natural person who represents the entity and is named in its incorporation document. Procurator — any person authorized in writing to represent the client in some business
      - `cpfNumber` string, required — CPF of the procurator. For business links this field may hold a CPF or a CNPJ (kept for backward compatibility — prefer documentNumber + documentType)
      - `documentNumber` string — Document number of the procurator (CPF or CNPJ). Mirrors cpfNumber and is the canonical value to read
      - `documentType` 'CPF' | 'CNPJ' — Type of document carried by documentNumber
      - `civilName` string, required — Civil name of the procurator. For business procurators, may hold the company name
      - `socialName` string — Social name of the procurator, if any
    - `accounts` object[] — List of accounts of the client with valid consent. Only accounts that have explicit user consent are returned.
      - `compeCode` string, required — COMPE code of the account
      - `branchCode` string, required — Branch code of the account
      - `number` string, required — Number of the account
      - `checkDigit` string, required — Check digit of the account
      - `type` string, required — Type of the account
      - `subtype` string, required — Subtype of the account
    - `portabilitiesReceived` PortabilityReceived[] — Salary portabilities received by the institution from the client's previous paycheck banks (banco-folha). PF-only field
      - `employerName` string, required — Employer name as received in the portability message. When the employer is a legal entity, this is the company name
      - `employerDocument` string, required — Employer document (CPF or CNPJ) as received in the portability message
      - `paycheckBankDetainerCnpj` string, required — CNPJ of the bank that holds the paycheck account (banco-folha) as received in the portability message
      - `paycheckBankDetainerIspb` string, required — ISPB of the bank that holds the paycheck account as received in the portability message
      - `portabilityApprovalDate` string, date-time, required — Date the portability was approved
    - `paychecksBankLink` PaycheckBankLink[] — Paycheck-bank (banco-folha) links to employers, active or formerly active. PF-only field
      - `employerName` string, required — Employer name as registered when the paycheck account was opened. When the employer is a legal entity, this is the company name
      - `employerDocument` string, required — Employer document (CPF or CNPJ) as registered when the paycheck account was opened
      - `paycheckBankCnpj` string, required — CNPJ of the institution contracted to provide the paycheck service (banco-folha)
      - `paycheckBankIspb` string, required — ISPB of the institution contracted to provide the paycheck service
      - `accountOpeningDate` string, date-time, required — Date the paycheck account was opened
  - `socialName` string — Social name of the natural person, if any (the name by which travestis and transsexuals recognize themselves and are recognized in their community). PF-only field
  - `sex` 'FEMALE' | 'MALE' | 'OTHER' — Sex of the natural person. PF-only field
  - `maritalStatus` MaritalStatus — Marital status of the natural person
    - `code` 'SINGLE' | 'MARRIED' | 'WIDOWED' | 'JUDICIALLY_SEPARATED' | 'DIVORCED' | 'STABLE_UNION' | 'OTHER', required — Marital status code
    - `additionalInfo` string — Free-text complement. Populated when code is OTHER
  - `nationality` Nationality — Nationality of the natural person
    - `hasBrazilianNationality` boolean, required — Whether the client has Brazilian nationality
    - `otherNationalities` object[] — Other nationalities held by the client, if any
      - `countryCode` string, required — Country code in alpha3 ISO-3166 format
      - `documents` NationalityDocument[], required — Supporting documents for this nationality
        - `type` string, required — Document type (free text). Required when the nationality is not Brazilian
        - `number` string, required — Document number. Required when the nationality is not Brazilian
        - `country` string — Country name
        - `issueDate` string, date-time — Issue date of the document
        - `expirationDate` string, date-time — Expiration date of the document
        - `additionalInfo` string — Free-text complement
  - `otherDocuments` OtherDocument[] — List of other identification documents the natural person holds. PF-only field
    - `type` 'CNH' | 'RG' | 'NIF' | 'RNE' | 'OTHER', required — Document type
    - `typeAdditionalInfo` string — Free-text complement. Populated when type is OTHER
    - `number` string, required — Document number
    - `checkDigit` string — Check digit of the document, if it has one
    - `additionalInfo` string — Free-text complement, used to record the issuing authority (e.g. 'SSP/SP') when relevant
    - `expirationDate` string, date-time — Expiration date of the document
  - `passport` Passport — Passport metadata for the natural person. Applies when the client is a non-resident not required to register a CPF
    - `number` string, required — Passport number
    - `country` string, required — Issuing country in alpha3 ISO-3166 format
    - `issueDate` string, date-time — Issue date of the passport
    - `expirationDate` string, date-time — Expiration date of the passport
  - `incorporationDate` string, date-time — Date the business was incorporated. PJ-only field
  - `parties` BusinessParty[] — Partners and administrators of the business. PJ-only field
    - `type` 'PARTNER' | 'ADMINISTRATOR', required — Role of the party in the business. Administrator — runs the day-to-day, signs documents and legally responds for the entity. Partner — holds capital but may not be involved in administrative activities
    - `personType` 'NATURAL_PERSON' | 'LEGAL_ENTITY', required — Whether the party is a natural person or a legal entity
    - `documentType` 'CPF' | 'CNPJ' | 'PASSPORT' | 'OTHER_TRAVEL_DOCUMENT', required — Type of the party's identification document
    - `documentNumber` string, required — Number of the identification document (digits and check digit, if any)
    - `documentCountry` string — Issuing country of the document, alpha3 ISO-3166
    - `documentExpirationDate` string, date-time — Expiration date of the document
    - `documentIssueDate` string, date-time — Issue date of the document
    - `documentAdditionalInfo` string — Free-text complement when the document carries identification info that doesn't fit the other fields
    - `civilName` string — Civil name of the party. Required when personType is NATURAL_PERSON
    - `socialName` string — Social name of the natural-person party, if any
    - `companyName` string — Company name of the party. Required when personType is LEGAL_ENTITY
    - `tradeName` string — Trade name of the legal-entity party, if any
    - `startDate` string, date-time — Date the party's participation started
    - `shareholding` number — Shareholding fraction between 0 and 1 (e.g. 0.51 represents 51%, 1 represents 100%). Required when type is PARTNER and the shareholding is 25% or higher
  - `businessOtherDocuments` BusinessOtherDocument[] — List of additional documents for businesses headquartered abroad and not required to register a CNPJ. PJ-only field
    - `type` string, required — Type of the document (e.g. 'EIN')
    - `number` string, required — Document number
    - `country` string, required — Issuing country in alpha3 ISO-3166 format
    - `expirationDate` string, date-time — Expiration date of the document
  - `companiesCnpj` string[] — CNPJs of the financial institutions responsible for the customer cadastro. Numbers only, no mask

## Other responses

- `400` — Invalid parameters
- `404` — Identity not found
- `500` — Server Internal Error

---

[API](https://skmtc.dev/pluggy/apis/pluggy-api.md) · [All operations](https://skmtc.dev/pluggy/apis/pluggy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pluggy/pluggy-api/revisions/75e87ec7f9cd/schema)