Get a CDR Export Task

Request URL

GET {base_url}/uc-creport/api/v1/cdr/export/tasks/{taskId}

Request parameters

Headers


Parameter	Required	Type	Description
Authorization	Yes	String	The access token used for authentication. Format: Bearer `{access_token}`.
x-tenant-code	Yes	String	The tenant name. Note: You can obtain tenant name using the Query Tenants interface.

Path parameters


Parameter	Required	Type	Description
taskId	Yes	String	The ID of the export task to query. You can obtain the task ID using the Export CDRs interface.

Response parameters


Parameter	Type	Description
requestId	String	The unique ID of the request, which can be used to quickly locate the request.
code	String	The HTTP status code of the request. `200`: Request succeeded. Non-200 value: Request failed.
message	String	The status message of the request.
detailMessage	String	The detailed error information. When the request is successful, this parameter returns empty.
result	Object<Task_Detail_Result>	The details of the export task.

Task_Detail_Result


Parameter	Type	Description
task	Object<Export_Task_Info>	The details of the export task.

Export_Task_Info


Parameter	Type	Description
id	String	The ID of the task.
taskType	String	The type of the task.
status	String	The status of the task: `pending` `processing` `success` `failed`
message	String	The message of the task, which is the success prompt or the failure reason.
resourceId	String	The ID of the exported file resource. This parameter is available after the task succeeds.
createdAt	String	The time when the task was created, in Unix timestamp format (milliseconds).
updatedAt	String	The time when the task was last updated, in Unix timestamp format (seconds).
resourceExpired	Boolean	Whether the exported file resource has expired. `true`: The resource has expired and cannot be downloaded. `false`: The resource has not expired.
resourceExpireAt	String	The expiration time of the exported file resource, in Unix timestamp format (milliseconds). The value 0 indicates that the file never expires.

Example

Request example

GET /uc-creport/api/v1/cdr/export/tasks/374411691270496256 HTTP/1.1
Host: api.cn.novoone.com
Authorization: Bearer eyJraWQiOiJjbi0wLWtleS0xIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIxMDAwQGNvbG9ydGVzdDIiLCJncmFudF90eXBlIjoicGFzc3dvcmQiLCJ1c2VyX25hbWUiOiIxMDAwQGNvbG9ydGVzdDIiLCJzY29wZSI6WyJyZWFkIiwid3JpdGUiXSwiY2xpZW50X2V4dCI6eyJkZXNjcmlwdGlvbiI6IueuoeeQhuWQjuWPsFdlYuW6lOeUqCIsInBsYXRmb3JtIjoid2ViIn0sImV4cCI6MTc5MzM1NTUwMiwiaWF0IjoxNzkzMzMzOTAyLCJqdGkiOiIxMGQwNGYwYy0yMTIxLTRiMzktYjFlZC1kNDY5MDY0ODlhODQiLCJjbGllbnRfaWQiOiJub3ZvLWFkbWluLXdlYiIsInNpZCI6IjlkMTg5NjI3LTZhZTAtNDYxMC04ZTFhLWNiZWJmYzdlYTdmZiIsInVzZXJfZXh0Ijp7InJvbGVJZHMiOlsxMDJdLCJwdWlkIjozMDc2OTEzNjQ0OTE1OTk4NzIwLCJ0ZW5hbnRJZCI6MjA3OTUwNDIwNTMwOTE5NDI0MSwicGFyZW50VWNJZCI6MzA3NjkxMzY0NDg5MDgzMjg5NiwidGVuYW50Q29kZSI6ImNvbG9ydGVzdDIiLCJ0eXBlIjoiVF9VU0VSIiwidXNlcklkIjoyMDc5NzQ2OTE1Mzg4MDc2MDMzLCJlbWFpbCI6Imxlb0BzYW1wbGUuY29tIiwidXNlcm5hbWUiOiIxMDAwQGNvbG9ydGVzdDIiLCJ1Y0lkIjozMDc2OTEzNjQ0ODkwODMyODk2fX0.cpY9aTg-Twaa1itEHREfJRX2RaYmalfGeof0An6DYSYBl9moSYvsjsZwImpId5xKb1qsPsec0KSXTmASV9kMgonf1uv6AtNRw702SroZxYTHwA9_lwxM8TY66aOAyoeiewHhA0sCDtg-ZGiDaatHxSitiLMi4MMr8qyzvuXF_44bcucYSaf8Z7Iokiud9cM67Z4dAFdxQ_SSbmFtAmTa78VuSPA0R7fFyq86Fn-p6Xk767i0AXJI8a7H7GNKMPwuc5NJ3BtWcbWx8M_DKKNVO58wMO2d9_Q13-qjlmX44h0ml_GqtqSqkZS7wz3Bg2jPT3Q2yc7Ijm9rxqr1UvbGLg
x-tenant-code: jint

Response example

HTTP/1.1 200 OK
{
  "requestId": "e22fa5d79f98b57c20a9b60fbc4dbe17",
  "code": "200",
  "message": "SUCCESS",
  "detailMessage": "",
  "result": {
    "task": {
      "id": "374411691270496256",
      "taskType": "cdr_export",
      "status": "success",
      "message": "CDR-export-20261030121823-Mm3RjGrVmUcRKMW3.csv",
      "resourceId": "2116021874993991681",
      "createdAt": "1793333903431",
      "updatedAt": "1793333903",
      "resourceExpired": false,
      "resourceExpireAt": "1793337503585"
    }
  }
}