Get File Upload Status by ID

The Get File Upload Status by ID API accepts the upload ID as an input parameter and fetches the current status details such as success or bad data.This upload is returned by the engagement server when the file upload is initiated by invoking the upload API.

URL

The HTTP URL for Get File Upload Status by ID API is:

http://<<host>>:<<port>>/api/v1/batchinfo/status/{id}

Method

GET

Sample Responses

Bulk Geolocation

Upload Status Code 0 (In Progress)

{ "dataType" : "GEO_LOCATIONS",
"uploadStatusCode":0,
"statusMessage" : "Processing initialized",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Upload Status Code 200 (Completed)

{ "dataType" : "GEO_LOCATIONS",
"uploadStatusCode":200,
"statusMessage" : "Successfully imported all the locations",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Upload Status Code 400 (Missing or invalid data for one or more records)

{ "dataType" : "GEO_LOCATIONS",
"uploadStatusCode":400,
"statusMessage" : "Uploaded file has got errors",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Upload Status Code 500 (Invalid Headers)

{ "dataType" : "GEO_LOCATIONS",
"uploadStatusCode":500,
"statusMessage" : "Invalid header value xxxx provided.",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Import Users

Upload Status Code 0 (In Progress)

{ "dataType" : "AUDIENCE_MEMBERS",
"uploadStatusCode":0,
"statusMessage" : "Processing initialized",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Upload Status Code 200 (Completed)

{ "dataType" : "AUDIENCE_MEMBERS",
"uploadStatusCode":200,
"statusMessage" : "Successfully uploaded requests of count : 100",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Upload Status Code 400 (File has invalid data for one or more users)

{ "dataType" : "AUDIENCE_MEMBERS",
"uploadStatusCode":400,
"statusMessage" : "Uploaded file has got errors",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Upload Status Code 500 (Invalid Headers)

{ "dataType" : "AUDIENCE_MEMBERS",
"uploadStatusCode":500,
"statusMessage" : "Header containing user attribute list is missing or few of the required attributes are missing in the uploaded file. Also, check if the file delimiter and selected delimiter type are matching",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Upload Status Code 500 (Processing failed)

 { "dataType" : "AUDIENCE_MEMBERS",
"uploadStatusCode":500,
"statusMessage" : "Failed to upload audience members",
"importedDate" : "09/20/2016 01:29:08 PM GMT",
"importedBy" : "admin",
"id" : "73666813857345684569"
}

Bulk Push

Upload Status Code 0 (In Progress)

{
"dataType": "BULK_PUSH",
"statusMessage": "Processing Initialized",
"importedDate": "09/20/2016 12:56:46 PM GMT",
"importedBy": "bvuser@voltmx.com",
"uploadStatusCode": 0,
"id": "7366557095490382404"
}

Upload Status Code 200 (Processing successful)

{
"dataType": "BULK_PUSH",
"statusMessage": "Messages processed successfully",
"importedDate": "03/15/2018 03:25:32 PM IST",
"importedBy": "xxx@yyy.com",
"requestId": 8825493127599914874,
"uploadStatusCode": 200,
"id": "8825493117394875342"
}

Upload Status Code 400 (Invalid users)

 {
"dataType": "BULK_PUSH",
"statusMessage": "Invalid subscribers",
"importedDate": "09/20/2016 01:31:20 PM GMT",
"importedBy": "bvuser@voltmx.com",
"uploadStatusCode": 400,
"id": "7366689869640468247"
}

Upload Status code 400 (Invalid users)

{
"dataType" : "BULK_PUSH",
"statusMessage" : "Queued sucessfully, but contains invalid subscribers.",
"importedDate" : "09/20/2016 12:38:55 PM GMT",
"importedBy" : "bvuser@voltmx.com",
"uploadStatusCode": 400,
"id" : "7366488585436004154"
}

Upload Status Code 500 (Invalid format)

{
"dataType": "BULK_PUSH",
"statusMessage": "Line 15, Invalid values",
"importedDate": "09/20/2016 01:31:20 PM GMT",
"importedBy": "bvuser@voltmx.com",
"uploadStatusCode": 500,
"id": "7366689869640468247"
}

Response Status

Code	Description
Status 200	Messages queued sucessfullyProcessing initialized
Status 400	Invalid ID provided
Status 401	Unauthorized request
Status 500	Server failure to process request.