Is it possible to get null wrapUpCode in analytics detail queries - known limitation or query error

NICE CXone API & Integrations
1

Background

I am building a Data Action to normalize disposition codes from Genesys Cloud analytics. The goal is to map the wrapUpCode from the analytics detail API into a structured JSON object for downstream processing. I have verified that agents are correctly setting wrap-up codes in the UI, and the data appears in the standard reports.

Issue

When querying the endpoint GET /api/v2/analytics/details/query, the response payload consistently returns null for the wrapUpCode field, even when the query filters for interactions with specific status codes. Here is the JSON payload I am sending:

{
 "interval": "PT1H",
 "metrics": ["wrapUpCode"],
 "entities": [{"id": "queue-id-here", "type": "routingQueue"}],
 "groupBy": ["wrapUpCode"]
}

The response structure looks like this:

{
 "entities": [{
 "id": "wrapUpCode",
 "type": "wrapUpCode",
 "wrapUpCode": null
 }]
}

Troubleshooting

  • I have checked the metrics array and ensured wrapUpCode is included.
  • I tried switching to the analytics/summary/query endpoint, but the behavior is identical.
  • The API returns a 200 OK, so it is not a syntax error.

Is this a known limitation of the analytics detail API regarding wrap-up codes, or am I missing a specific configuration in the query body? I need this data to flow through my Data Action JSON transform.