Get all DVFs
Learn how to retrieve all Data Validation Functions (DVFs) configured for a tenant in a specific environment.
Use this operation to retrieve the Data Validation Functions (DVFs) configured for a tenant. The Data Validation runs on a dedicated service host, separate from your tenant's base API host. Reltio scopes the DVFs returned by the environment you specify in the request. For information about executing DVFs against entity data, see Validate entities using DVF.
HTTP method and endpoint
Use the following HTTP method and endpoint path to retrieve all DVFs for a tenant:
GET https://data-validation-functions.reltio.com/api/{tenantId}/dataValidationFunctionsThe following table describes the endpoint path parameters.
| Parameter | Type | Required | Description |
|---|---|---|---|
tenantId | String | Yes | The unique identifier of the tenant. |
Request headers
Include the following headers in the request. Use the env header to scope which DVFs are returned.
| Header | Value | Required |
|---|---|---|
Authorization | Bearer <access_token> | Yes |
env | The environment identifier that scopes the DVFs returned by this request. Results reflect only the DVFs configured for the specified environment. | Yes |
Request body
This operation doesn't require a request body.
Example request
Use the following example to see how a complete request is structured with headers and a JSON body.
GET https://data-validation-functions.reltio.com/api/{tenantId}/dataValidationFunctions
Authorization: Bearer <access_token>
env: {environment}
Response body
The response is an array of DVF objects.
| Field | Type | Description |
|---|---|---|
uri | String | Unique identifier of the DVF. |
name | String | Name of the DVF. |
label | String | Display label of the DVF. |
description | String | Description of the DVF. |
expression | String | The validation expression evaluated by the DVF. |
action | String | The action taken when the DVF evaluates to true, for example WARNING. |
message | String | Validation message for the function when the expression is evaluated as true. |
validationEvent | String | The lifecycle event on which the DVF runs. |
status | String | Whether the DVF is ACTIVE or inactive. |
attribute | String | The attribute URI the DVF validates. |
createdBy | String | The user or system that created the DVF. |
createdTime | String | Epoch timestamp, in milliseconds, when the DVF was created. |
updatedBy | String | The user or system that last updated the DVF. |
updatedTime | String | Epoch timestamp, in milliseconds, when the DVF was last updated. |
applyOn | String | Scope the DVF applies to, for example OV (object version). |
sourceTypes | Array | Source types the DVF applies to. Empty when the DVF applies to all sources. |
Example response
The following example shows a response with two DVFs.
[
{
"uri": "c71e300b-d992-4e9b-80d2-f2245cab6521",
"name": "ShortNameCheck",
"label": "",
"description": "Name is suspiciously short",
"expression": "regexp(attributes.Name.value, '^.{1,3}$')",
"action": "WARNING",
"message":"Name must contain at least 3 characters."
"validationEvent": "ALL",
"status": "ACTIVE",
"attribute": "configuration/entityTypes/Organization/attributes/Name",
"createdBy": "jane.doe@example.com",
"createdTime": "1783418619169",
"updatedBy": "jane.doe@example.com",
"updatedTime": "1783418619169",
"applyOn": "OV",
"sourceTypes": []
},
{
"uri": "5f3e9a21-7c44-4b8e-9d12-3a6f8e0b1c9d",
"name": "InvalidGTINFormat",
"label": "",
"description": "GTIN does not match the expected format",
"expression": "regexp(attributes.GTIN.value, '^[0-9]{12,14}$')",
"action": "ERROR",
"message": "GTIN must match the standard 14-digit format."
"validationEvent": "ALL",
"status": "ACTIVE",
"attribute": "configuration/entityTypes/Product/attributes/GTIN",
"createdBy": "jane.doe@example.com",
"createdTime": "1783418700000",
"updatedBy": "jane.doe@example.com",
"updatedTime": "1783418700000",
"applyOn": "OV",
"sourceTypes": []
},
...
]Error codes and recommended actions
The following table lists the possible error responses returned by this API.
| HTTP status code | Error code | Description | Recommended action |
|---|---|---|---|
| 401 Unauthorized | MISSING | Missing or invalid authentication credentials. | Provide a valid bearer token. |
| 403 Forbidden | MISSING | Insufficient permissions. | Confirm the account has DVF read permissions. |
| 500 Internal Server Error | MISSING | Unexpected server-side error. | Retry; contact support if the issue persists. |
| 503 Service Unavailable | MISSING | The service is temporarily unavailable. | Retry after a delay. |
Related pages
For more information, see Validate entities using DVF, Get DVFs by entity type, and Get DVF by URI.