GET/items/{id}

Consultar

Recupera o recurso do item pelo seu id

Parameters

Path Parameters

Name	Type	Description
`id`required	string (uuid)	Identificador primário do Item

Responses

200O item foi recuperado

object

Objeto Item

idrequiredstring

Identificador principal

connectorobject

Objeto do conector

idrequirednumber (integer)

Identificador principal

namestring

Nome da instituição

institutionUrlstring

Página inicial da instituição

imageUrlstring

Imagem do logotipo hospedado pelo Pluggy

primaryColorstring

Cor primária

typestring

Tipo de instituição

countrystring

País localizado

credentialsobject[]

Parâmetros necessários para iniciar a conexão

hasMFAboolean

O conector requer um MFA para ser executado?

productsstring[]

Produtos suportados pelo conector

productCoveragestring[]

Quais subprodutos a instituição oferece, na própria terminologia do diretório de Open Finance (por exemplo, INVESTMENTS:TREASURE_TITLES, CREDIT_OPERATIONS:INVOICE_FINANCINGS). Onde produtos indicam se o conector atende a investimentos, isso diz quais: um conector que lista INVESTMENTS pode atender a um dos cinco recursos de investimento ou a todos os cinco. Ausente para conectores diretos, que não têm participantes de Open Finance.

oauthboolean

Se 'true', o conector requerirá um fluxo Oauth para ser executado

oauthUrlstring

URL para realizar o fluxo Oauth, se necessário

resetPasswordUrlstring

URL para a instituição financeira para redefinir a senha

healthobject

Status de saúde do conector

isOpenFinanceboolean

Indica se o conector utiliza as APIs regulamentadas de Open Finance

isSandboxboolean

Indica se o conector é um conector de sandbox, destinado a testes em vez de uma instituição real

supportsPaymentInitiationboolean

Indica se o conector suporta a API de iniciação de pagamento

supportsScheduledPaymentsboolean

Indica se o conector suporta pagamentos agendados

supportsSmartTransfersboolean

Indica se o conector suporta transferências inteligentes

supportsBoletoManagementboolean

Indica se o conector suporta gerenciamento de boleto

supportsAutomaticPixboolean

Indica se o conector suporta Pix automático

createdAtstring (date-time)

Data de criação

updatedAtstring (date-time)

Data da última modificação

statusrequiredstring

Status do Item

executionStatusrequiredstring

Status da execução da sincronização

errorobject

Mensagem de erro detalhada

coderequiredstring

Error code

messagerequiredstring

Detailed error message

providerMessagestring

Information provider by the institution mainly when user needs to perform an action

attributesobject

'{ [key]:[value] }'. Additional information necessary for future executions, used for example in some device authorization flow

parameterobject

Detalhes de credenciais para um connector

namerequiredstring

Nome da chave

labelrequiredstring

Rótulo para entrada

typerequiredstring

Tipo de credencial necessária

textpasswordnumberimageselect

assistiveTextstring

Texto para ajudar o usuário ao preencher a entrada

datastring

Usado para retornar imagens em base64

placeholderstring

Texto de exemplo para a entrada

validationstring

Validação de regex para a entrada do usuário

validationMessagestring

Mensagem de validação quando a entrada não corresponde à expressão regular

mfaboolean

A Credencial é um parâmetro MFA e deve ser atualizada a cada execução.

optionsobject[]

Lista de valores possíveis para a entrada

optionalrequiredboolean

Se a credencial pode ser deixada em branco. Sempre presente; padrão é falso.

instructionsstring

Instruções para ajudar o usuário a obter esta credencial

expiresAtstring (date-time)

Data de expiração do valor da credencial, quando a instituição define uma.

userActionobject

Detalhes da ação do usuário para um item

instructionsrequiredstring

Instruções relacionadas à ação do usuário

attributesobject

'{ [key]:[value] }'. Informações adicionais relacionadas à ação do usuário, por exemplo, em algum fluxo de autorização de dispositivo

expiresAtstring (date-time)

Data de expiração da ação do usuário

typerequiredstring

Tipo de ação que o usuário deve realizar: escanear um código QR ou autorizar o acesso no aplicativo da instituição.

qrauthorize-access

webhookUrlstring

Url para ser notificado sobre mudanças de item

createdAtstring (date-time)

Data de criação

updatedAtstring (date-time)

Data da última modificação

lastUpdatedAtstring (date-time)

Data da última sincronização

statusDetailobject

Status detalhado do item. Este campo estará presente quando o status for PARTIAL_SUCCESS ou quando um produto no item tiver avisos.

accountsobject

Status detalhado do produto

creditCardsobject

Status detalhado do produto

transactionsobject

Status detalhado do produto

investmentsobject

Status detalhado do produto

identityobject

Status detalhado do produto

investmentsTransactionsobject

Status detalhado do produto

paymentDataobject

Status detalhado do produto

loansobject

Status detalhado do produto

accountStatementsobject

Status detalhado do produto

nextAutoSyncAtstring (date-time)

Data da próxima auto-sincronização, ou nulo se a auto-sincronização estiver desativada para este Item

consecutiveFailedLoginAttemptsnumber (integer)

Execuções consecutivas que terminam com um status LOGIN_ERROR

consentExpiresAtstring (date-time)

Data de expiração do consentimento

resourcesCollectedAtstring (date-time) | null

Apenas Open Finance. Quando a lista de recursos da instituição financeira foi lida pela última vez para este Item, ou `null` se nunca foi. Emparelha com `GET /items/{id}/resources`: uma lista vazia lá significa que a instituição não compartilhou nada quando isso está definido, e que a lista nunca foi obtida quando isso é `null`.

productsstring[]

Produtos coletados pelo item

itemsstring

ACCOUNTSCREDIT_CARDSTRANSACTIONSPAYMENT_DATAINVESTMENTSINVESTMENTS_TRANSACTIONSIDENTITYBROKERAGE_NOTEMOVE_SECURITYLOANS

Example response

json

{
  "id": "e062ab2b-9006-45e8-b689-defabba53647",
  "connector": {
    "id": 200,
    "name": "MeuPluggy",
    "primaryColor": "ef294b",
    "institutionUrl": "https://meu.pluggy.ai/",
    "country": "BR",
    "type": "PERSONAL_BANK",
    "credentials": [],
    "imageUrl": "https://cdn.pluggy.ai/assets/connector-icons/sandbox.svg",
    "hasMFA": false,
    "oauth": true,
    "health": {
      "status": "ONLINE",
      "stage": null
    },
    "products": [
      "ACCOUNTS",
      "TRANSACTIONS",
      "CREDIT_CARDS",
      "INVESTMENTS",
      "INVESTMENTS_TRANSACTIONS",
      "PAYMENT_DATA",
      "IDENTITY",
      "BROKERAGE_NOTE"
    ],
    "createdAt": "2023-09-12T16:44:13.900Z",
    "isSandbox": false,
    "isOpenFinance": false,
    "updatedAt": "2024-11-26T13:33:44.296Z",
    "supportsPaymentInitiation": false,
    "supportsScheduledPayments": false,
    "supportsSmartTransfers": false,
    "supportsBoletoManagement": false
  },
  "createdAt": "2024-09-19T13:10:31.212Z",
  "updatedAt": "2024-09-19T13:11:23.613Z",
  "status": "UPDATED",
  "executionStatus": "SUCCESS",
  "lastUpdatedAt": "2024-09-19T13:11:23.595Z",
  "webhookUrl": null,
  "error": null,
  "clientUserId": "user@example.com",
  "consecutiveFailedLoginAttempts": 0,
  "statusDetail": null,
  "parameter": null,
  "userAction": null,
  "nextAutoSyncAt": null,
  "consentExpiresAt": null,
  "resourcesCollectedAt": null,
  "products": [
    "ACCOUNTS",
    "CREDIT_CARDS",
    "TRANSACTIONS",
    "INVESTMENTS",
    "IDENTITY",
    "INVESTMENTS_TRANSACTIONS",
    "PAYMENT_DATA"
  ],
  "oauthRedirectUri": null
}

curl -X GET \
  'https://api.pluggy.ai/items/{id}' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'

Resposta de exemplo

{
  "id": "e062ab2b-9006-45e8-b689-defabba53647",
  "connector": {
    "id": 200,
    "name": "MeuPluggy",
    "primaryColor": "ef294b",
    "institutionUrl": "https://meu.pluggy.ai/",
    "country": "BR",
    "type": "PERSONAL_BANK",
    "credentials": [],
    "imageUrl": "https://cdn.pluggy.ai/assets/connector-icons/sandbox.svg",
    "hasMFA": false,
    "oauth": true,
    "health": {
      "status": "ONLINE",
      "stage": null
    },
    "products": [
      "ACCOUNTS",
      "TRANSACTIONS",
      "CREDIT_CARDS",
      "INVESTMENTS",
      "INVESTMENTS_TRANSACTIONS",
      "PAYMENT_DATA",
      "IDENTITY",
      "BROKERAGE_NOTE"
    ],
    "createdAt": "2023-09-12T16:44:13.900Z",
    "isSandbox": false,
    "isOpenFinance": false,
    "updatedAt": "2024-11-26T13:33:44.296Z",
    "supportsPaymentInitiation": false,
    "supportsScheduledPayments": false,
    "supportsSmartTransfers": false,
    "supportsBoletoManagement": false
  },
  "createdAt": "2024-09-19T13:10:31.212Z",
  "updatedAt": "2024-09-19T13:11:23.613Z",
  "status": "UPDATED",
  "executionStatus": "SUCCESS",
  "lastUpdatedAt": "2024-09-19T13:11:23.595Z",
  "webhookUrl": null,
  "error": null,
  "clientUserId": "user@example.com",
  "consecutiveFailedLoginAttempts": 0,
  "statusDetail": null,
  "parameter": null,
  "userAction": null,
  "nextAutoSyncAt": null,
  "consentExpiresAt": null,
  "resourcesCollectedAt": null,
  "products": [
    "ACCOUNTS",
    "CREDIT_CARDS",
    "TRANSACTIONS",
    "INVESTMENTS",
    "IDENTITY",
    "INVESTMENTS_TRANSACTIONS",
    "PAYMENT_DATA"
  ],
  "oauthRedirectUri": null
}