GET/connectors

Lista

Este endpoint recupera todos os conectores disponíveis.

Parameters

Query Parameters

Name	Type	Description
`countries`	array	Uma lista de países de conectores para filtrar.
`types`	array	Uma lista de tipos de conectores para filtrar.
`name`	string	Busca de nome semelhante do conector
`sandbox`	boolean	Inclua conectores de sandbox se definido como verdadeiro (padrão: falso).
`healthDetails`	boolean	Inclua detalhes de saúde sobre as últimas conexões e a porcentagem de erros (taxa de conexão)
`isOpenFinance`	boolean	Filtre os conectores pelo atributo `isOpenFinance`. Se não for enviado, não filtrará.
`supportsPaymentInitiation`	boolean	Filtre conectores pelo atributo `supportsPaymentInitiation`. Se não enviado, não filtrará.
`supportsSmartTransfers`	boolean	Filtre os conectores pelo atributo `supportsSmartTransfers`. Se não for enviado, não filtrará.
`supportsAutomaticPix`	boolean	Filtre os conectores pelo atributo `supportsAutomaticPix`. Se não for enviado, não filtrará.

Responses

200Recupere uma lista de todos os conectores

object

Connector List Response

pagenumber (double)

totalnumber (double)

totalPagesnumber (double)

resultsobject[]

itemsobject

Connector object

Example response

json

{
  "page": 1,
  "total": 1,
  "totalPages": 1,
  "results": [
    {
      "id": 601,
      "name": "Itaú",
      "primaryColor": "EC7000",
      "institutionUrl": "https://www.itau.com.br/assets/dam/publisher/07_itau_empresas/13_open_banking/logos_regulatorio_bacen/opb_log_reg_bac_itau_img_01.svg",
      "country": "BR",
      "type": "PERSONAL_BANK",
      "credentials": [
        {
          "validation": "^\\d{3}\\.?\\d{3}\\.?\\d{3}-?\\d{2}$",
          "validationMessage": "CPF deve ter 11 números.",
          "label": "CPF",
          "name": "cpf",
          "type": "number",
          "placeholder": "",
          "optional": false
        }
      ],
      "imageUrl": "https://cdn.pluggy.ai/assets/connector-icons/201.svg",
      "hasMFA": false,
      "oauth": true,
      "health": {
        "status": "ONLINE",
        "stage": null
      },
      "products": [
        "ACCOUNTS",
        "TRANSACTIONS",
        "IDENTITY",
        "CREDIT_CARDS",
        "PAYMENT_DATA",
        "LOANS",
        "INVESTMENTS"
      ],
      "createdAt": "2023-09-01T18:05:09.145Z",
      "isSandbox": false,
      "isOpenFinance": true,
      "updatedAt": "2024-07-16T15:34:08.028Z",
      "supportsPaymentInitiation": true,
      "supportsScheduledPayments": true,
      "supportsSmartTransfers": true,
      "supportsBoletoManagement": true
    }
  ]
}

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

Resposta de exemplo

{
  "page": 1,
  "total": 1,
  "totalPages": 1,
  "results": [
    {
      "id": 601,
      "name": "Itaú",
      "primaryColor": "EC7000",
      "institutionUrl": "https://www.itau.com.br/assets/dam/publisher/07_itau_empresas/13_open_banking/logos_regulatorio_bacen/opb_log_reg_bac_itau_img_01.svg",
      "country": "BR",
      "type": "PERSONAL_BANK",
      "credentials": [
        {
          "validation": "^\\d{3}\\.?\\d{3}\\.?\\d{3}-?\\d{2}$",
          "validationMessage": "CPF deve ter 11 números.",
          "label": "CPF",
          "name": "cpf",
          "type": "number",
          "placeholder": "",
          "optional": false
        }
      ],
      "imageUrl": "https://cdn.pluggy.ai/assets/connector-icons/201.svg",
      "hasMFA": false,
      "oauth": true,
      "health": {
        "status": "ONLINE",
        "stage": null
      },
      "products": [
        "ACCOUNTS",
        "TRANSACTIONS",
        "IDENTITY",
        "CREDIT_CARDS",
        "PAYMENT_DATA",
        "LOANS",
        "INVESTMENTS"
      ],
      "createdAt": "2023-09-01T18:05:09.145Z",
      "isSandbox": false,
      "isOpenFinance": true,
      "updatedAt": "2024-07-16T15:34:08.028Z",
      "supportsPaymentInitiation": true,
      "supportsScheduledPayments": true,
      "supportsSmartTransfers": true,
      "supportsBoletoManagement": true
    }
  ]
}