Skip to main content
GET
/
api
/
data-readiness
/
data-assets
/
tables
/
by-fqn
Get a table by FQN
curl --request GET \
  --url https://api.example.com/api/data-readiness/data-assets/tables/by-fqn \
  --header 'Authorization: Bearer <token>'
{
  "name": "<string>",
  "fqn": "<string>",
  "id": "<string>",
  "description": "<string>",
  "summary_text": "<string>",
  "owners": [
    "<string>"
  ],
  "tags": [
    {}
  ],
  "domain": "<string>",
  "version": 123,
  "columns": [
    {
      "name": "<string>",
      "id": "<string>",
      "fqn": "<string>",
      "data_type": "<string>",
      "description": "<string>",
      "display_name": "<string>",
      "data_type_display": "<string>",
      "business_rules": "<string>",
      "business_definition": "<string>",
      "summary_text": "<string>",
      "constraint": {},
      "column_relationships": [
        {}
      ],
      "tags": [
        {}
      ],
      "data_quality": [
        {}
      ]
    }
  ],
  "is_dq_tagged": false,
  "is_dq_rules_generated": false,
  "requires_approval": true
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token authentication. Include the token in the Authorization header as: Authorization: Bearer <token>. The JWT must contain valid client_id, and project_id claims for tenant isolation and SDK routing.

Query Parameters

​
fqn
string
required

Fully qualified name of the table (e.g., service.database.schema.table)

Minimum string length: 1
​
include_pending_workflow
boolean
default:false

Include pending workflow info and proposed changes

​
include_dq
boolean
default:false

Include DQ tags, rules, and execution results from the readiness DB

Response

Successful Response

Table domain model for API responses and requests.

Clean DTO representing a database table without ORM metadata. Tables can include nested columns for convenient creation. Supports business domain association and data quality rule definitions. Used in API layer, excludes infrastructure concerns.

​
name
string
required

Table name

​
fqn
string
required

Fully qualified name

​
id
string | null

Unique table identifier (UUID as string)

​
description
string | null

Table description

​
summary_text
string | null

Summary text for semantic search embedding

​
owners
string[] | null

List of owner names

​
tags
Tags · object[] | null

List of tag dicts with tagFQN, name, justification, etc.

​
domain
string | null

Business domain this table belongs to

​
version
number | null

Entity version number

​
columns
Column · object[] | null

Nested columns (populated on creation or request)

​
is_dq_tagged
boolean
default:false

Whether any column has DQ tags

​
is_dq_rules_generated
boolean
default:false

Whether any column has DQ rules generated

​
requires_approval
boolean | null

Whether the pending workflow for this table requires human approval before saving