List databases

GET /projects/:projectid/databases

The project's databases and their ids.

Every other database endpoint takes a database id, so start here if you do not already have one.

Authentication

• Project API key: The credential for everything external. Created in Project Settings, bound to one project, and limited to the scopes it was granted. Format: proj.<keyId>.<secret>.
• Required permission: databases.read on all databases.

Path parameters

Name	Type	Required	Default	Description
projectid	string	Yes	-	The project id.

Example request

curl -X GET \
  -H "Authorization: proj.KEY_ID.SECRET" \
  {{BASE_URL}}/projects/{{PROJECT_ID}}/databases

Responses

200

The project's databases.

{
  "databases": [
    {
      "id": "db_4hT2",
      "name": "analytics",
      "createdDate": "2026-04-02T11:20:04.221Z"
    }
  ]
}

403

The key lacks read permission on all databases.

Notes

• Listing is project-wide, so it needs the permission on all rather than on one database id.