Skip to main content

List databases

List the databases in a project.

GET /projects/:projectid/databases

Authentication​

Send the project API key in the Authorization header, without a Bearer prefix. Requires databases.read on all databases. A grant for a single database does not allow this project-wide listing.

Request​

No request body or pagination parameters.

Example​

Use the environment variables from the database overview. Replace example IDs with your own.

curl --include --request GET \
--header "Authorization: ${INTELLECTIBLE_PROJECT_API_KEY}" \
"${INTELLECTIBLE_PUBLIC_API_URL}/projects/${INTELLECTIBLE_PROJECT_ID}/databases"

Response​

200 OK

{
"databases": [
{
"id": "database_id",
"name": "Customer data",
"createdDate": 1793318400000
}
]
}

Each entry contains its id, display name, and createdDate. Newly created databases use a Unix timestamp in milliseconds; metadata fields can be null when unavailable. An empty project returns {"databases":[]}.

Use the returned id as dbid in subsequent requests.

See Errors and safe retries for shared failure handling.