Get audit query status - Precisely Data Integrity Suite

Data Integrity Suite APIs

Product
Data_Integrity
Spatial_Analytics
Data_Enrichment
geo_addressing_1
Services
Spatial Analytics
Data Enrichment
Geo Addressing
ft:title
Data Integrity Suite APIs
ft:locale
en-US
PublicationType
pt_developer
copyrightfirst
2023
copyrightlast
2026

Retrieves the current status of a query using its unique identifier.

HTML

GET https://hostname/private/v1/audit/queries/{queryId}

Request

Query parameters

Property Required Type Description
queryId Yes string The unique identifier of the audit query used to retrieve its current status.

Response

Response examples

{
  "queryId": "a1b2c3d4-5678-90ef-gh12-ijklmnopqrst",
  "status": "Running",
  "createdAt": "2026-03-24T18:42:15Z",
  "createdBy": "user@example.com"
}
{
  "status": 400,
  "type": "BadRequest",
  "message": "The request is invalid.",
  "detail": {
    "queryId": "Query ID must be a valid identifier."
  }
}
{
  "status": 401,
  "type": "Unauthorized",
  "message": "Authentication credentials are missing or invalid.",
  "detail": {
    "authorization": "Bearer token is missing or expired."
  }
}
{
  "status": 403,
  "type": "Forbidden",
  "message": "You do not have permission to access this resource.",
  "detail": {
    "permission": "audit.query.read",
    "reason": "Required permission is missing."
  }
}
{
  "status": 404,
  "type": "NotFound",
  "message": "The specified query was not found.",
  "detail": {
    "queryId": "No query exists 
	}
}
{
  "status": 500,
  "type": "InternalServerError",
  "message": "An unexpected error occurred.",
  "detail": {
    "service": "audit-query-service",
    "errorId": "f3a9c2e4-8b21-4d9a-a7c1-9f6c2b1d
	}
}