Skip to main content
GET
https://sandbox.getcollate.io/api
/
v1
/
databaseSchemas
GET /v1/databaseSchemas
from metadata.sdk import configure
from metadata.sdk.entities import DatabaseSchemas

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# List with pagination
page = DatabaseSchemas.list(limit=50, fields=["owners", "tags"])
for s in page.entities:
    print(f"{s.fullyQualifiedName}")
    if s.owners:
        print(f"  Owners: {[o.name for o in s.owners]}")

# List all with auto-pagination
all_schemas = DatabaseSchemas.list_all(batch_size=100)
for schema in all_schemas:
    print(f"{schema.fullyQualifiedName}")
{
  "data": [
    {
      "id": "f681432b-e66c-4096-a1cd-7771358c5323",
      "name": "information_schema",
      "fullyQualifiedName": "Glue.default.information_schema",
      "description": "This **mock** database contains tables related to the Glue service",
      "version": 0.1,
      "updatedAt": 1769982658171,
      "updatedBy": "admin",
      "href": "http://localhost:8585/api/v1/databaseSchemas/f681432b-e66c-4096-a1cd-7771358c5323",
      "owners": [],
      "service": {
        "id": "0fab117a-4c58-4ebb-9d42-beab0768fa8e",
        "type": "databaseService",
        "name": "Glue",
        "fullyQualifiedName": "Glue",
        "displayName": "Glue",
        "deleted": false,
        "href": "http://localhost:8585/api/v1/services/databaseServices/0fab117a-4c58-4ebb-9d42-beab0768fa8e"
      },
      "serviceType": "Glue",
      "database": {
        "id": "9655ba5b-b8d7-419c-98f4-16b976692ad8",
        "type": "database",
        "name": "default",
        "fullyQualifiedName": "Glue.default",
        "description": "This **mock** database contains tables related to the Glue service",
        "displayName": "default",
        "deleted": false,
        "href": "http://localhost:8585/api/v1/databases/9655ba5b-b8d7-419c-98f4-16b976692ad8"
      },
      "tables": [
        {
          "id": "49cae725-62e6-48b4-b604-7ea915659d9a",
          "type": "table",
          "name": "sales",
          "fullyQualifiedName": "Glue.default.information_schema.sales",
          "description": "Sales data",
          "displayName": "sales",
          "deleted": false,
          "href": "http://localhost:8585/api/v1/tables/49cae725-62e6-48b4-b604-7ea915659d9a"
        },
        {
          "id": "b9988329-cb3e-469b-8d10-d6a21de8b0b9",
          "type": "table",
          "name": "marketing",
          "fullyQualifiedName": "Glue.default.information_schema.marketing",
          "description": "Marketing data",
          "displayName": "marketing",
          "deleted": false,
          "href": "http://localhost:8585/api/v1/tables/b9988329-cb3e-469b-8d10-d6a21de8b0b9"
        }
      ],
      "tags": [],
      "deleted": false,
      "sourceUrl": "https://www.glue.com/information_schema",
      "domains": [],
      "entityStatus": "Unprocessed"
    }
  ],
  "paging": {
    "after": "...",
    "total": 28
  }
}

List Database Schemas

List all database schemas with optional filtering and pagination.

Query Parameters

database
string
Filter by database fully qualified name.
domain
string
Filter by domain fully qualified name.
limit
integer
default:"10"
Maximum number of results to return (max: 1000000).
before
string
Cursor for backward pagination.
after
string
Cursor for forward pagination.
fields
string
Comma-separated list of fields to include: owners, tables, usageSummary, tags, certification, extension, domains, sourceHash, followers.
include
string
default:"non-deleted"
Include all, deleted, or non-deleted entities.
GET /v1/databaseSchemas
from metadata.sdk import configure
from metadata.sdk.entities import DatabaseSchemas

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# List with pagination
page = DatabaseSchemas.list(limit=50, fields=["owners", "tags"])
for s in page.entities:
    print(f"{s.fullyQualifiedName}")
    if s.owners:
        print(f"  Owners: {[o.name for o in s.owners]}")

# List all with auto-pagination
all_schemas = DatabaseSchemas.list_all(batch_size=100)
for schema in all_schemas:
    print(f"{schema.fullyQualifiedName}")
{
  "data": [
    {
      "id": "f681432b-e66c-4096-a1cd-7771358c5323",
      "name": "information_schema",
      "fullyQualifiedName": "Glue.default.information_schema",
      "description": "This **mock** database contains tables related to the Glue service",
      "version": 0.1,
      "updatedAt": 1769982658171,
      "updatedBy": "admin",
      "href": "http://localhost:8585/api/v1/databaseSchemas/f681432b-e66c-4096-a1cd-7771358c5323",
      "owners": [],
      "service": {
        "id": "0fab117a-4c58-4ebb-9d42-beab0768fa8e",
        "type": "databaseService",
        "name": "Glue",
        "fullyQualifiedName": "Glue",
        "displayName": "Glue",
        "deleted": false,
        "href": "http://localhost:8585/api/v1/services/databaseServices/0fab117a-4c58-4ebb-9d42-beab0768fa8e"
      },
      "serviceType": "Glue",
      "database": {
        "id": "9655ba5b-b8d7-419c-98f4-16b976692ad8",
        "type": "database",
        "name": "default",
        "fullyQualifiedName": "Glue.default",
        "description": "This **mock** database contains tables related to the Glue service",
        "displayName": "default",
        "deleted": false,
        "href": "http://localhost:8585/api/v1/databases/9655ba5b-b8d7-419c-98f4-16b976692ad8"
      },
      "tables": [
        {
          "id": "49cae725-62e6-48b4-b604-7ea915659d9a",
          "type": "table",
          "name": "sales",
          "fullyQualifiedName": "Glue.default.information_schema.sales",
          "description": "Sales data",
          "displayName": "sales",
          "deleted": false,
          "href": "http://localhost:8585/api/v1/tables/49cae725-62e6-48b4-b604-7ea915659d9a"
        },
        {
          "id": "b9988329-cb3e-469b-8d10-d6a21de8b0b9",
          "type": "table",
          "name": "marketing",
          "fullyQualifiedName": "Glue.default.information_schema.marketing",
          "description": "Marketing data",
          "displayName": "marketing",
          "deleted": false,
          "href": "http://localhost:8585/api/v1/tables/b9988329-cb3e-469b-8d10-d6a21de8b0b9"
        }
      ],
      "tags": [],
      "deleted": false,
      "sourceUrl": "https://www.glue.com/information_schema",
      "domains": [],
      "entityStatus": "Unprocessed"
    }
  ],
  "paging": {
    "after": "...",
    "total": 28
  }
}

Returns

Returns a paginated list of database schema objects. By default, only basic fields are included. Use the fields parameter to request additional data.

Response

data
array
Array of database schema objects.
paging
object
Pagination information.