Fetch Pre-signed URL

Returns a pre-signed URL using which the exported data can be downloaded.

Endpoint

URL: https://<<hostname>>/export/uzng/v1/convdata/download/

Method: GET

curl --location 'https://<<hostname>>/export/uzng/v1/convdata/download/09a69856-26f4-a0f5-b7aa663054c4' \
     --header 'Authorization: Bearer kxYejBQYWVFRERuS3dfcjdkU2s2UyJ9.eyJodHRwczovL2FwaS51bmlwaG9yZS5jb20vcm9sZXMiOlsiQWNjb3VudCBBZG1pbmlzdHJhdG9yIiwiYWRtaW4iLCJ1X2FkbWluaXN0cmF0b3IiLCJpbnRlcmFjdF9hY2NvdW50X2FkbWluIl0sImh0dHBzOi8vYXBpLnVuaXBob3JlLmNvbS9lbWFpbF9pZCI6Im5ndGVzdF9hY2NvdW50X2FkbWluQHVuaS5jb20iLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJuZ3Rlc3RfYWNjb3VudF9hZG1pbkB1bmkuY29tIiwiZmFtaWx5X25hbWUiOiJhZG1pbiB0b20iLCJlbWFpbCI6Im5ndGVzdF9hY2NvdW50X2FkbWluQHVuaS5jb20iLCJodHRwczovL2FwaS51bmlwaG9yZS5jb20vYXV0aDBfbmFtZSI6ImFkbWluIHRvbSIsImh0dHBzOi8vYXBpLnVuaXBob3JlLmNvbS91c2VyX2lkIjoiYXV0aDB8NjYxMzg4MGY0NWFiZDRmMDM1OGMxNjYyIiwiaHR0cHM6Ly9hcGkudW5pcGhvcmUuY29tL3VwZGF0ZWRfYXQiOiIyMDI1LTAzLTE5VDE0OjExOjQ1LjA4MFoiLCJodHRwczovL2FwaS51bmlwaG9yZS5jb20vdXNlcl9tZXRhZGF0YSI6eyJhZGRpdGlvbmFsU2V0dGluZ3MiOnsiYWxpYXMiOiJuZ3Rlc3RfYWNjb3VudF9hZG1pbiIsImRlcGFydG1lbnQiOiIiLCJkaXZpc2lvbiI6IiIsImV4dGVuc2lvbiI6IiIsImV4dGVybmFsUmVmZXJlbmNlSWQiOm51bGwsInBob25lIjoiIiwicG9saWN5IjpudWxsLCJ0aXRsZSI6IiIsInVzZXJUeXBlIjoiIn0sImNsaWVudElkIjoiIiwiY2xpZW50X2lkIjoibmd0ZXN0X2FjY291bnRfYWRtaW5AdW5pLmNvbSIsInJvbGVBdHRyaWJ1dGVzIjp7InNraWxsSWQiOiIiLCJ0ZWxlcGhvbnkgZXh0ZW5zaW9uIjpudWxsfSwidXBkYXRlZF9hdCI6IjE3Mzk0MjUwNjk4MTAifSwiaHR0cHM6Ly9hcGkudW5pcGhvcmUuY29tL3RlbmFudCI6ImZlNTcyMTU2LTIyMTItNDU4ZS04NzNhLTZhYzYwYmViZjY0MiIsImh0dHBzOi8vYXBpLnVuaXBob3JlLmNvbS90ZW5hbnRfbmFtZSI6InVhbnotbmd0ZXN0IiwiaHR0cHM6Ly9hcGkudW5pcGhvcmUuY29tL2NsdXN0ZXIiOiJ1cyIsImlzcyI6Imh0dHBzOi8vZGV2LWcyajVtdTJ6LnVzLmF1dGgwLmNvbS8iLCJzdWIiOiJhdXRoMHw2NjEzODgwZjQ1YWJkNGYwMzU4YzE2NjIiLCJhdWQiOlsiYXBpLnVuaXBob3JlLmNvbSIsImh0dHBzOi8vZGV2LWcyajVtdTJ6LnVzLmF1dGgwLmNvbS91c2VyaW5mbyJdLCJpYXQiOjE3NDIzOTM1MDgsImV4cCI6MTc0MjQ3OTkwOCwic2NvcGUiOiJvcGVuaWQgcHJvZmlsZSBlbWFpbCBvZmZsaW5lX2FjY2VzcyIsIm9yZ19pZCI6Im9yZ19TcjJkRHJXSTlvaFY5OFJxIiwiYXpwIjoidnB1bURCMTFJRm45WENnT1JCc0JSdElUd1NxczZDOFYiLCJwZXJtaXNzaW9ucyI6WyJhdWRpdC1sb2c6dmlldzp1Y2FwdHVyZSIsImNvbmZpZ3VyYXRpb246c3lzdGVtOnVjYXB0dXJlIiwiY3JlYXRlOnRlbmFudDpsb29rZXIiLCJkZWxldGU6dXNlcnMiLCJkZXNpZ246Ymk6bG9va2VyIiwicG9saWN5OmFjdGl2YXRlOnVjYXB0dXJlIiwicG9saWN5OmNyZWF0ZTp1Y2FwdHVyZSIsInBvbGljeTpkZWFjdGl2YXRlOnVjYXB0dXJlIiwicmVhZDpleHBlcmllbmNlcyIsInJlYWQ6b3JnSGllcmFyY2h5IiwicmVhZDp1YXNzaXN0IiwicmVjb3JkaW5nOmxvY2s6dWNhcHR1cmUgIiwicmVjb3JkaW5nOm9uLWRlbWFuZDp1Y2FwdHVyZSIsInJlY29yZGluZzp2aWV3LWxpdmU6dWNhcHR1cmUiLCJyZWNvcmRpbmc6dmlldy1tZXRhZGF0YTp1Y2FwdHVyZSIsInJlY29yZGluZzp2aWtaGllcmFyY2h5Iiwid3JpdGU6ZXhwZXJpZW5jZXMiLCJ3cml0ZTp1YXNzaXN0Il19.avYCureu2ZJyThPmGDvNhlXW_X82WdNkEt5v6DvSGJOnqp6CMRVQH2qu1KGkaFPoQ04DMpKp6bBpCn2g9THzvkoJvmu5d1Ey1TFo-JtzTbSMJI3NeYuJ3MNeoP_FEiKuJpGUwSCkMsB-Gyx6y3n_J8vQsQO3dmGnpIMNdcRTMZTxhLPm-SwfmqtPet67Zg_F3pEVh8kDjopNNoZ1-pZpkGn6qJqbXmn1yWK5bWvDU0Uv16CaKV8AFzkcOlBSrkxswsj1bEu3TSNujlHcltkCsUMvco13wARC359vMRmD6actc2npdLQ-NDfpr9rVR4JDIIx3SAAikUSDUwWSAfQTsQ'

Header Parameter

Authorization - Bearer <Token>

Note

To obtain an authorization token, click here.

Path Parameter

Parameter Name	Datatype	Description	Required/ Optional
jobId	Number	Enter the job ID to fetch its pre-signed URL.	Required

Sample Response 1

{
      "code": 200,    
      "message": "URL generated successfully",    
      "data": {        
                "preSignedUrl": "https://xxxxxx.s3.us-east-2.amazonaws.com/exports/31a0adeb-a829-4d63-a871-3519c445f124/0f533358-86b5-4ebd-8c88-513e64f943f2/0f533358-86b5-4ebd-8c88-513e64f943f2.zip?response-content-type=application%2Fzip&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIATWYKH5YDG42SLUYK%2F20250325%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20250325T101654Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=3b5487105ddb4d083718f30b95c0edfa45621d1257527282a0dddd6adb201963",        
                "expiresAt": "2025-03-25T11:16:54.097932"    
               }
}

Caution

By default, the pre-signed URL will automatically expire an hour after it is generated. To know the exact time of expiry, see the expiresAt parameter in the response.

Sample Response 2

{
    "code": 200,
    "message": "job ID: <JobId> is still inprogress, please try after some time",
    "data": null
}

Response and Error Codes

Response Code	Condition	Message	Description
200	OK	URL generated successfully job ID: <JobId> is still inprogress, please try after some time	The pre-signed URL is generated for the given job ID. For the given job ID, the export data job is still in progress.
404	Not Found	Export job not found for job ID: <jobId>, tenant ID: <tenantId>	Ensure the correct Job ID and Tenant ID are provided.
410	Gone	Export Link is expired for job ID: <JobId> under tenant ID: <TenantId>. Kindly schedule a new job	The pre-signed URL is permanently removed. Execute the Bulk Data Export API again to create a new URL.

In this section:

Uniphore Help Center Portal