CIcint
Reconciliations

Submit a list of RIDs for positive or negative reconciliation

Submits a CSV file of respondent IDs and reason codes to be reconciled. This file can contain a mixture of positive and negative reconciliations. Reconciliation can be submitted when target group is in Live or Paused or Complete status.

This action creates an asynchronous job to process the file. A 202 Accepted response indicates that the file has been successfully queued for processing. You can use the request_id returned in the response body to track the status of the job.

Key behaviors:

  • File Format: The file must be a CSV with no header row. Each line must contain a respondent ID and a reason code, separated by a comma.
  • File Size: The file can contain up to 100,000 rows.
post/demand/accounts/{account_id}/reconciliations

Request

Path parameters

account_idinteger required

The account's unique identifier.

Example:101

Query parameters

namestring

The name of the file containing requests to reconcile.

Headers

Idempotency-Keystring

A shallow unique ID used as part of the deduplication mechanism for mutable operations. Value should be UUIDv4.

Example:96C65204-90C2-4DCB-9393-B8226DD50C76
Content-Type'text/csv' | 'application/csv' required

The content type of the request body.

Request body text/csv

string required

Format each line as: RID, reason code. Do not include a header row.

Example request

"0F1CE179-A917-49FF-9D50-B05FC91F7BD4,11\n75F1404C-65F6-4937-AD2A-588E4F66E07F,11\n9C23131D-388B-4E03-97B3-CF783E491445,932"

Response

Accepted reconciliation request for processing.

namestring

The name of the submitted reconciliation request

request_idstring ulid

UniqueID generated for the reconciliation request

Example response

{
  "name": "Reconciliation_file_name.csv",
  "request_id": "01F8K8P3Z5KNYR5H0GQZAYGQJ9"
}

Changes

No recorded changes to this operation across all 1 revision of this API.