Skip to main content

List Data Policies

List data policies that define field transformations, normalization rules, and lookup cascades applied during resolution runs. Supports cursor-based pagination.

Data policies are first-class, versioned configuration objects that define how field values are transformed, normalized, and validated during resolution runs. Each policy contains a set of fields (output contract) and rules (transformation logic) that are compiled into an executable pipeline. Policies support 14 rule types including direct mapping, lookup cascades, Lua scripting, and deterministic computation.

Use this endpoint to list all data policies in your workspace. Policies are returned in reverse chronological order by default. Each policy can have multiple versions, allowing you to iterate on transformation logic without affecting in-flight resolution runs that have already captured a policy snapshot.

GET/v1/data-policies

Response

Response fields

dataarrayArray of data policy objects.
data[].idstringData policy UUID.
data[].namestringHuman-readable policy name.
data[].descriptionstring | nullOptional description of the policy purpose.
data[].versionintegerCurrent version number.
data[].created_atstringISO 8601 creation timestamp.
data[].updated_atstringISO 8601 last update timestamp.

curl

Response

{
  "data": [
    {
      "id": "p1a2b3c4-e5f6-7890-abcd-ef1234567890",
      "name": "Invoice Normalization",
      "description": "Standardize currency codes, country names, and date formats for invoice processing",
      "version": 3,
      "created_at": "2024-10-01T09:00:00.000Z",
      "updated_at": "2024-10-15T11:30:00.000Z"
    }
  ],
  "cursor": "eyJpZCI6InAxYTJiM2M0In0="
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.