GET Async/{clientId}/Import/{accessToken}/Status
Retrieve status
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
clientId |
Your required clientId used to access the WebAPI. A 404 is returned if this value is invalid. |
string |
Required |
accessToken |
Access token returned from InitiateBulkImport call |
integer |
Required |
Body Parameters
None.
Response Information
Response Codes
HTTP Status Code | Text | Description |
---|---|---|
200 | OK | The request was successfully processed. |
400 | Bad Request | The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again. |
401 | Unauthorized | Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again. |
403 | Forbidden | The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again. |
500 | Internal Server Error | The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence. |
Resource Description
BulkImportStatusName | Description | Type | Additional information |
---|---|---|---|
TotalRecordsReceived |
Total number of records received |
integer | |
ValidationSuccessful |
Number of records that passed validation |
integer | |
ValidationFailed |
Number of records that failed validation |
integer | |
Processed |
Number of records processed |
integer | |
Pending |
Number of records left to process |
integer | |
Exceptions |
Number of exception records |
integer | |
NotHonored |
Number of records that were not honored |
integer | |
AccessToken |
Token used to stage, execute, and retrieve import status and failed records |
integer | |
Status |
The Status of the import. "Initiated", "Staging", "Queued", "Processing", "Completed", or "Failed" |
string | |
Expires |
Date the access token expires |
string | |
Name |
The name of the bulk import |
string |
Required Max length: 100 Min length: 1 |
DataStageDuration |
Determines the number of days for retaining the staged data before deleting it. If not specified, the default is 3 days. The DataStageDuration cannot exceed 10 days. |
integer |
Range: inclusive between 0 and 10 |
MatchCriteria |
Criteria used to lookup and update a Profile |
string | |
MatchValue |
Value used to lookup and update a Profile |
string | |
RefreshAlternateIds |
If true, existing AlternateIds that are NOT included in the import, will be deactivated. Defaults to false |
boolean | |
RefreshContacts |
If true, existing profile contact elements that are NOT included in the import, will be deactivated along with any preferences associated with them. Defaults to false |
boolean | |
RefreshCustomFields |
If true, existing CustomFields that are NOT included in the import, will be deleted. Defaults to false |
boolean | |
RefreshGroups |
If true, existing Groups that are NOT included in the import, will be deactivated. Defaults to false |
boolean | |
RefreshTags |
If true, existing Tags that are NOT included in the import, will be deleted. Defaults to false |
boolean |
Response Formats
application/json, text/json, application/json-patch+json
{ "TotalRecordsReceived": 1, "ValidationSuccessful": 2, "ValidationFailed": 3, "Processed": 4, "Pending": 5, "Exceptions": 6, "NotHonored": 7, "AccessToken": 8, "Status": "sample string 9", "Expires": "sample string 10", "Name": "sample string 11", "DataStageDuration": 12, "MatchCriteria": "sample string 13", "MatchValue": "sample string 14", "RefreshAlternateIds": true, "RefreshContacts": true, "RefreshCustomFields": true, "RefreshGroups": true, "RefreshTags": true }
application/xml, text/xml
<BulkImportStatus xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ProfileServices.REST.Models.Import"> <DataStageDuration>12</DataStageDuration> <MatchCriteria>sample string 13</MatchCriteria> <MatchValue>sample string 14</MatchValue> <Name>sample string 11</Name> <RefreshAlternateIds>true</RefreshAlternateIds> <RefreshContacts>true</RefreshContacts> <RefreshCustomFields>true</RefreshCustomFields> <RefreshGroups>true</RefreshGroups> <RefreshTags>true</RefreshTags> <AccessToken>8</AccessToken> <Expires>sample string 10</Expires> <Status>sample string 9</Status> <Exceptions>6</Exceptions> <NotHonored>7</NotHonored> <Pending>5</Pending> <Processed>4</Processed> <TotalRecordsReceived>1</TotalRecordsReceived> <ValidationFailed>3</ValidationFailed> <ValidationSuccessful>2</ValidationSuccessful> </BulkImportStatus>