Skip to main content
GET
/
bases
Get databases
curl --request GET \
  --url https://tables.fillout.com/api/v1/bases \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "bad4b276-f604-47ad-86e5-d2ae4f60968f",
    "name": "<string>",
    "tables": [
      {
        "id": "<string>",
        "name": "<string>",
        "order": 123,
        "primaryFieldId": "<string>",
        "fields": [
          {
            "id": "<string>",
            "name": "<string>",
            "type": "single_line_text",
            "template": {},
            "order": 123
          }
        ],
        "views": [
          {
            "id": "<string>",
            "name": "<string>",
            "type": "<string>",
            "config": {
              "sorts": [
                {}
              ],
              "hiddenFieldIds": [
                "<string>"
              ],
              "fieldWidths": {},
              "orderedFieldIds": [
                "<string>"
              ]
            }
          }
        ]
      }
    ],
    "createdAt": "2025-10-18T02:08:14.784Z",
    "updatedAt": "2025-10-18T02:08:14.784Z",
    "workspaceId": "<string>"
  }
]
Lists all databases for your organization.
  • Returns all databases accessible to your API key
  • Each database includes complete table and field structure
  • Use workspaceId parameter to filter by workspace

Authorizations

Authorization
string
header
required

Enter your Fillout API key. Format: Bearer <api_key>

Response

List of databases

id
string<uuid>
required

Unique UUID identifier for the database

Example:

"bad4b276-f604-47ad-86e5-d2ae4f60968f"

name
string
required

Name of the database

tables
object[]
required

List of tables in the database

createdAt
string<date-time>
required

ISO timestamp of when the database was created

Example:

"2025-10-18T02:08:14.784Z"

updatedAt
string<date-time>
required

ISO timestamp of when the database was last updated

Example:

"2025-10-18T02:08:14.784Z"

workspaceId
string

Workspace ID that owns this database