List a Database's Connections

GET /v1/databases/{uuid}/connections

List the applications connected to a database. A connection gives one app one database through one of its users: the app gets {PREFIX}DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD and DATABASE_URL in the chosen environment. Create and remove connections with Connect / Disconnect. Requires Databases read.

The database POST /v1/applications/{uuid}/database creates is connected to its app like any other (no prefix). An older per-app database not moved onto a connection has none; GET /v1/databases/{uuid} lists its app in connected_apps with legacy: true.

Connection object

uuid string (uuid)
The connection's id (the {connection_uuid} of a disconnect).
env_prefix string
The variable prefix, e.g. ORDERS_; "" for the plain names.
environment string
The deploys that get the variables: production, preview or all.
var_set string
standard: the six variables.
env_names array
The variable names the connection gives the app (and reserves on it).
application_uuid / application_name string
The connected app.
database_uuid / database_name string
The database.
database_user_uuid / database_user_name string
The user the app connects as.
created_at string (RFC 3339)
When the app was connected.

Response (200 OK)

{"connections": […]}.

Errors

403
No Databases read, no active account, or no managed databases on the plan.
404
database not found.
503
databases_unavailable.
Request
curl "https://api.ngris.com/v1/databases/019c2a41-7d3e-7b52-a1c4-5e9f0b3d6a18/connections" \ -H "X-API-KEY: <your_api_key>"
Response — 200 OK
{ "connections": [ { "uuid": "019c2a71-9a2d-7d06-8e41-3f7b2c9d0a58", "env_prefix": "ORDERS_", "environment": "all", "var_set": "standard", "created_at": "2026-10-18T09:02:00Z", "application_uuid": "019be838-d261-7d9b-9499-71995a3a91c6", "application_name": "orders-api", "database_uuid": "019c2a41-7d3e-7b52-a1c4-5e9f0b3d6a18", "database_name": "orders-db", "database_user_uuid": "019c2a41-7d40-7e15-9b63-2f8c4d1a7e95", "database_user_name": "app", "env_names": ["ORDERS_DB_HOST", "ORDERS_DB_PORT", "ORDERS_DB_NAME", "ORDERS_DB_USER", "ORDERS_DB_PASSWORD", "ORDERS_DATABASE_URL"] } ] }

List an Application's Database Connections

GET /v1/applications/{uuid}/database-connections

List the databases an application is connected to (the dashboard's Connected databases card on the app's Environment tab). Same connection objects as above. Works on a downgraded plan too, so you can see what an app still uses. Requires Databases read and Endpoints read.

Response (200 OK)

{"connections": […]}; empty for an app with none (a static app never has any).

Errors

403
No Databases read or Endpoints read, no active account, or Static application hosting is not available on your plan.
404
application not found.
503
databases_unavailable.
Request
curl "https://api.ngris.com/v1/applications/019be838-d261-7d9b-9499-71995a3a91c6/database-connections" \ -H "X-API-KEY: <your_api_key>"
Homepage Docs Dashboard Docs API Docs nvelox Dashboard