Compliance Content

Submit content for impact.com compliance monitoring and retrieve job status and results.

Create compliance content submission

post

Submits one or more content items for compliance monitoring. Content is processed asynchronously — the response returns immediately with a QueuedUri pointing to the job's status endpoint.

Use the returned URI (or extract the submission Id from its tail) to poll the job with the Get compliance submission status endpoint. Once the status is COMPLETED, retrieve the per-item results from the Get compliance submission results endpoint.

Accepts either application/json (recommended; supports batch submissions via the Contents array) or application/x-www-form-urlencoded (single item only).

Path parameters

AccountSIDstringRequired

Your Agency Account SID.

Example: IRq8mWJybvoQ1020978kbj7am8zzM2dBL1

Body

application/jsonapplication/x-www-form-urlencoded

A batch compliance content submission. The Context block describes the source and content type for the whole batch; Contents is the array of individual items to monitor.

Responses

202

Submission accepted and queued for processing.

application/json

Statusstring · enumOptional

Confirmation status. Returns QUEUED on a successful submission.

Example: QUEUEDPossible values:

QueuedUristringOptional

The relative URI of the submission job. Use this (or its trailing Id) to poll the job with the Get compliance submission status endpoint.

Example: /Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Compliance/Content/ComplianceAPISubmissions/content_api_1603459292102

400

Validation error. The request body is missing required fields or contains invalid values.

application/json

401

Unauthorized. Check that your Account SID and Auth Token are correct.

post/Agencies/{AccountSID}/Compliance/Content

HTTPcURLJavaScriptPython

POST /Agencies/{AccountSID}/Compliance/Content HTTP/1.1
Host: api.impact.com
Content-Type: application/json
Accept: */*
Content-Length: 327

{
  "Context": {
    "Type": "PAGE",
    "Source": "CONTENT_API"
  },
  "Contents": [
    {
      "AdvertiserId": 1048291,
      "CampaignId": 12345,
      "Url": "https://www.partner-site.example.com/review/product-x",
      "Type": "PAGE",
      "Reason": "Quarterly compliance audit",
      "Source": "CONTENT_API",
      "PartnerId": 67890,
      "Language": "en",
      "PaidLink": false,
      "Monitored": true,
      "Cadence": true
    }
  ]
}

application/jsonapplication/x-www-form-urlencoded

{
  "Status": "QUEUED",
  "QueuedUri": "/Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Compliance/Content/ComplianceAPISubmissions/content_api_1603459292102"
}

Get compliance submission status

get

Retrieves the current processing status of a compliance content submission job.

Once the Status value reaches COMPLETED, the per-item results can be retrieved using the Get compliance submission results endpoint at the URI returned in ResponseUri.

Path parameters

AccountSIDstringRequired

Your Agency Account SID.

Example: IRq8mWJybvoQ1020978kbj7am8zzM2dBL1

IdstringRequired

The submission ID returned in the QueuedUri of the create response (e.g., content_api_1603459292102).

Example: content_api_1603459292102

Responses

200

The current status of the submission.

application/json

The processing status of a compliance content submission job.

JobIdstringOptional

The unique identifier of the submission job. Matches the Id path parameter.

Example: content_api_1603459292102

Statusstring · enumOptional

The current processing status of the job.

Value	Description
QUEUED	The submission has been received and is awaiting processing.
RUNNING	The submission is being processed.
COMPLETED	Processing has finished — per-item results can be retrieved.

Example: COMPLETEDPossible values:

Sourcestring · enumOptional

The source system that submitted the content. Only CONTENT_API is currently supported.

Example: CONTENT_APIPossible values:

Typestring · enumOptional

The type of compliance content in this submission. Only PAGE is currently supported.

Example: PAGEPossible values:

StartDatestring · date-timeOptional

The date and time the job started processing, in ISO 8601 format.

Example: 2026-01-15T09:22:11Z

EndDatestring · date-timeOptional

The date and time the job finished processing, in ISO 8601 format. Empty until the job reaches COMPLETED.

Example: 2026-01-15T09:23:47Z

SuccessintegerOptional

The count of content items in the submission that were processed successfully.

Example: 8

PartialSuccessintegerOptional

The count of content items that were processed but reported warnings or non-fatal issues.

Example: 1

ErrorintegerOptional

The count of content items that failed processing.

Example: 1

ResponseUristringOptional

The relative URI from which the full per-item results can be retrieved. Available once Status is COMPLETED.

Example: /Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Compliance/Content/ComplianceAPISubmissions/Response/content_api_1603459292102

401

Unauthorized. Check that your Account SID and Auth Token are correct.

404

Submission not found. Verify the Id belongs to a submission made by this agency.

application/json

get/Agencies/{AccountSID}/Compliance/Content/ComplianceAPISubmissions/{Id}

HTTPcURLJavaScriptPython

GET /Agencies/{AccountSID}/Compliance/Content/ComplianceAPISubmissions/{Id} HTTP/1.1
Host: api.impact.com
Accept: */*

{
  "JobId": "content_api_1603459292102",
  "Status": "COMPLETED",
  "Source": "CONTENT_API",
  "Type": "PAGE",
  "StartDate": "2026-01-15T09:22:11Z",
  "EndDate": "2026-01-15T09:23:47Z",
  "Success": 8,
  "PartialSuccess": 1,
  "Error": 1,
  "ResponseUri": "/Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Compliance/Content/ComplianceAPISubmissions/Response/content_api_1603459292102"
}

Get compliance submission results

get

Retrieves the per-item compliance results of a completed submission. Call this only when the job's Status (from the Get compliance submission status endpoint) is COMPLETED.

The relative URI is also returned as the ResponseUri field in the status response.

Path parameters

AccountSIDstringRequired

Your Agency Account SID.

Example: IRq8mWJybvoQ1020978kbj7am8zzM2dBL1

IdstringRequired

The submission ID returned in the QueuedUri of the create response.

Example: content_api_1603459292102

Responses

200

Per-item processing results for the submission.

No content

401

Unauthorized. Check that your Account SID and Auth Token are correct.

404

Submission not found.

get/Agencies/{AccountSID}/Compliance/Content/ComplianceAPISubmissions/Response/{Id}

HTTPcURLJavaScriptPython

GET /Agencies/{AccountSID}/Compliance/Content/ComplianceAPISubmissions/Response/{Id} HTTP/1.1
Host: api.impact.com
Accept: */*

No content