Get aggregator connection

Returns a single Open-Finance data-aggregator (Pluggy/Belvo) connection by id. The result is secret-free by construction: no credential material (clientId/secret/ciphertext) is ever returned. A non-aggregator connection id returns 404.

GET /v1/discovery/aggregator-connections/{id}

Get aggregator connection

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/discovery/aggregator-connections/{id} \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "accountRef": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "awaitingConsent": false,
  "baseUrl": "https://api.pluggy.ai",
  "configName": "pluggy-main",
  "vendor": "pluggy"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Parámetros de ruta

id · string · requerido

Opaque aggregator connection id

Respuesta

200

application/json

OK

accountRef · string · requerido

Stored opaque vendor account reference (Pluggy itemId, Belvo link id); empty while the connection is awaiting consent

Ejemplo:

"a1b2c3d4-5678-90ab-cdef-1234567890ab"

awaitingConsent · boolean · requerido

Whether the connection is still awaiting the end customer's vendor consent (no vendor item/link bound yet)

Ejemplo:

false

baseUrl · string<uri> · requerido

Stored vendor API base URL

Ejemplo:

"https://api.pluggy.ai"

configName · string · requerido

Connection config name the operator mints a token against

Ejemplo:

"pluggy-main"

vendor · enum<string> · requerido

Aggregator vendor the connection is bound to

Opciones disponibles: pluggy, belvo

Ejemplo:

"pluggy"