List collections with row counts and last update

GET

/api/v1/{bucket}/collections

• Production
• Development

Returns all 19 warehouse collections with row count and last updated timestamp for the specified bucket. Also includes a total row count across all collections in the meta.

Authorizations

• BearerAuth
• ApiKeyAuth

Parameters

Path Parameters

bucket

required

string

/^[a-zA-Z0-9][a-zA-Z0-9\-]*$/

Flock bucket ID. The caller must have access to this bucket.

Example

example

Responses

200

Collection list with counts and timestamps

object

data

required

Array<object>

object

collection

required

string

Example

person

row_count

required

integer

Example

1250

last_updated

required

ISO timestamp of most recently updated record, or null.

string

nullable

Example

2026-02-10 14:30:00

meta

required

object

bucket

string

total_rows

integer

Example

12345

Example

{
  "data": [
    {
      "collection": "person",
      "row_count": 1250,
      "last_updated": "2026-02-10 14:30:00"
    },
    {
      "collection": "organisation",
      "row_count": 340,
      "last_updated": "2026-02-09 09:15:00"
    }
  ],
  "meta": {
    "bucket": "example",
    "total_rows": 12345
  }
}

401

Authentication required

object

error

required

object

code

required

Machine-readable error code.

string

Example

unauthorized

message

required

Human-readable error message.

string

Example

Authentication required

Example

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required"
  }
}

403

Access denied to bucket

object

error

required

object

code

required

Machine-readable error code.

string

Example

unauthorized

message

required

Human-readable error message.

string

Example

Authentication required

Example

{
  "error": {
    "code": "forbidden",
    "message": "Access denied to bucket 'example'"
  }
}