Get a discovered connection

Use this endpoint to retrieve a single discovered connection by its internal identifier.

GET /v1/discovery/connections/{connectionId}

Get a discovered connection

cURL

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

200

Example

{
  "configName": "prod-ledger-db",
  "databaseName": "ledger",
  "databaseType": "POSTGRESQL",
  "host": "db.internal.example.com",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "lastSeenAt": "2026-06-17T14:32:05Z",
  "port": 5432,
  "schemaDiscovered": true,
  "status": "available",
  "userName": "matcher_ro",
  "baseURL": "https://sandbox.provider.example",
  "schema": "public"
}

Autorizaciones

Authorization · string · header · requerido

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

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

Parámetros de ruta

connectionId · string<uuid> · requerido

The unique identifier of the connection. Connection ID (UUID)

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Respuesta

200

application/json

Connection details

configName · string · requerido

Connection configuration name

Ejemplo:

"prod-ledger-db"

databaseName · string · requerido

Database name

Ejemplo:

"ledger"

databaseType · string · requerido

Database engine type (canonical engine token as stored)

Ejemplo:

"POSTGRESQL"

host · string · requerido

Database host; empty for REST connector connections, whose service address is reported as baseURL

Ejemplo:

"db.internal.example.com"

id · string · requerido

Internal Matcher connection identifier

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

lastSeenAt · string<date-time> · requerido

Timestamp the connection was last observed healthy (RFC 3339)

Ejemplo:

"2026-06-17T14:32:05Z"

port · integer<int64> · requerido

Database port

Ejemplo:

5432

schemaDiscovered · boolean · requerido

Whether table schemas have been discovered for this connection

status · string · requerido

Current lifecycle status of the connection as reported by the extraction engine

Ejemplo:

"available"

userName · string · requerido

Database user name the connection authenticates as

Ejemplo:

"matcher_ro"

baseURL · string<uri>

Per-connection API base URL of a REST connector connection; absent when the deployment default applies and for database connectors

Ejemplo:

"https://sandbox.provider.example"

schema · string

Schema/namespace within the database, when set

Ejemplo:

"public"