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.