# Compliance Content

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

## Create compliance content submission

> 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).

```json
{"openapi":"3.1.0","info":{"title":"Agency API — Compliance Content","version":"3.0"},"tags":[{"name":"Compliance Content","description":"Submit content for impact.com compliance monitoring and retrieve job status and results."}],"servers":[{"url":"https://api.impact.com","description":"Production"}],"paths":{"/Agencies/{AccountSID}/Compliance/Content":{"post":{"operationId":"createComplianceContent","summary":"Create compliance content submission","description":"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.\n\nUse 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.\n\nAccepts either `application/json` (recommended; supports batch submissions via the `Contents` array) or `application/x-www-form-urlencoded` (single item only).","tags":["Compliance Content"],"parameters":[{"name":"AccountSID","in":"path","required":true,"description":"Your Agency Account SID.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceSubmissionRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/ComplianceContent"}}}},"responses":{"202":{"description":"Submission accepted and queued for processing.","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string","description":"Confirmation status. Returns `QUEUED` on a successful submission.","enum":["QUEUED"]},"QueuedUri":{"type":"string","description":"The relative URI of the submission job. Use this (or its trailing `Id`) to poll the job with the **Get compliance submission status** endpoint."}}}}}},"400":{"description":"Validation error. The request body is missing required fields or contains invalid values.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized. Check that your Account SID and Auth Token are correct."}}}}},"components":{"schemas":{"ComplianceSubmissionRequest":{"type":"object","description":"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.","required":["Context","Contents"],"properties":{"Context":{"type":"object","description":"Describes the context of this submission batch.","required":["Type","Source"],"properties":{"Type":{"type":"string","description":"The type of content being submitted. Only `PAGE` is currently supported.","enum":["PAGE"],"default":"PAGE"},"Source":{"type":"string","description":"The source system submitting the content. Only `CONTENT_API` is currently supported.","enum":["CONTENT_API"],"default":"CONTENT_API"}}},"Contents":{"type":"array","description":"One or more content items to submit for monitoring.","items":{"$ref":"#/components/schemas/ComplianceContent"}}}},"ComplianceContent":{"type":"object","description":"A single content item submitted for compliance monitoring.","required":["AdvertiserId","CampaignId","Url","Type","Reason","Source"],"properties":{"AdvertiserId":{"type":"integer","description":"The unique numeric identifier of the advertiser account that owns the program this content is associated with."},"CampaignId":{"type":"integer","description":"The unique numeric identifier of the program (campaign) this content is part of."},"Url":{"type":"string","format":"uri","description":"The full URL of the content page being submitted for review."},"Type":{"type":"string","description":"The type of compliance content being submitted. Only `PAGE` is currently supported.","enum":["PAGE"]},"Reason":{"type":"string","description":"A free-text description of why this content is being submitted for compliance review. Useful for audit trails."},"Source":{"type":"string","description":"The source system submitting the content. Only `CONTENT_API` is currently supported.","enum":["CONTENT_API"]},"PartnerId":{"type":"integer","description":"The numeric ID of the partner publishing the content. **Required** if the program has \"Partner ID Required\" enabled in its compliance settings."},"ContentLabels":{"type":"string","description":"A comma-separated list of labels for categorizing the content (e.g., `\"product-review,paid\"`). Free-form values defined by the agency."},"Products":{"type":"string","description":"A comma-separated list of product SKUs that this content refers to."},"Keywords":{"type":"array","description":"Keywords associated with the content. Each keyword has its own approval status and monitoring function — useful for tracking compliance against specific terms.","items":{"$ref":"#/components/schemas/Keyword"}},"Language":{"type":"string","description":"The language of the content as an ISO 639-1 two-letter code (e.g., `en`, `fr`, `es`)."},"PaidLink":{"type":"boolean","description":"Whether this content is a paid (sponsored) link. Defaults to `false`."},"Monitored":{"type":"boolean","description":"Whether to enroll this content in impact.com's ongoing Compliance Monitoring service. Defaults to `false`."},"Cadence":{"type":"boolean","description":"Whether to apply cadence rules (re-checking on a schedule) to this content within Compliance Monitoring. Only effective when `Monitored` is `true`."}}},"Keyword":{"type":"object","description":"A keyword tracked against a content submission.","required":["Name","Status","Function"],"properties":{"Name":{"type":"string","description":"The keyword text to track within the content."},"Status":{"type":"string","description":"The approval status of this keyword for the content.\n\n| Value | Description |\n|---|---|\n| `APPROVED` | The keyword is approved for use in this content. |\n| `NOT_APPROVED` | The keyword is not approved for use in this content. |","enum":["APPROVED","NOT_APPROVED"]},"Function":{"type":"string","description":"The monitoring function applied to this keyword.\n\n| Value | Description |\n|---|---|\n| `MONITORED` | Monitor the keyword for compliance violations. |\n| `NOT_MONITORED` | Do not monitor the keyword. |\n| `CHANGE_DETECTION` | Trigger an alert when the keyword is added or removed. |\n| `DISCOVERY` | Discover and report new instances of the keyword across content. |","enum":["MONITORED","NOT_MONITORED","CHANGE_DETECTION","DISCOVERY"]}}},"ErrorResponse":{"type":"object","description":"Standard error response format for the Compliance Content API.","properties":{"Status":{"type":"string","description":"Error status. Returns `ERROR` for failed requests.","enum":["ERROR"]},"Message":{"type":"string","description":"A human-readable description of the error."},"Errors":{"type":"object","description":"Detailed validation errors. Present when the request body fails validation.","properties":{"Error":{"type":"object","properties":{"Field":{"type":"string","description":"The name of the field that failed validation."},"Message":{"type":"string","description":"A description of why the field failed validation."}}}}}}}}}}
```

## Get compliance submission status

> 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\`.

```json
{"openapi":"3.1.0","info":{"title":"Agency API — Compliance Content","version":"3.0"},"tags":[{"name":"Compliance Content","description":"Submit content for impact.com compliance monitoring and retrieve job status and results."}],"servers":[{"url":"https://api.impact.com","description":"Production"}],"paths":{"/Agencies/{AccountSID}/Compliance/Content/ComplianceAPISubmissions/{Id}":{"get":{"operationId":"getComplianceSubmissionStatus","summary":"Get compliance submission status","description":"Retrieves the current processing status of a compliance content submission job.\n\nOnce 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`.","tags":["Compliance Content"],"parameters":[{"name":"AccountSID","in":"path","required":true,"description":"Your Agency Account SID.","schema":{"type":"string"}},{"name":"Id","in":"path","required":true,"description":"The submission ID returned in the `QueuedUri` of the create response (e.g., `content_api_1603459292102`).","schema":{"type":"string"}}],"responses":{"200":{"description":"The current status of the submission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionStatus"}}}},"401":{"description":"Unauthorized. Check that your Account SID and Auth Token are correct."},"404":{"description":"Submission not found. Verify the `Id` belongs to a submission made by this agency.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"SubmissionStatus":{"type":"object","description":"The processing status of a compliance content submission job.","properties":{"JobId":{"type":"string","description":"The unique identifier of the submission job. Matches the `Id` path parameter."},"Status":{"type":"string","description":"The current processing status of the job.\n\n| Value | Description |\n|---|---|\n| `QUEUED` | The submission has been received and is awaiting processing. |\n| `RUNNING` | The submission is being processed. |\n| `COMPLETED` | Processing has finished — per-item results can be retrieved. |","enum":["QUEUED","RUNNING","COMPLETED"]},"Source":{"type":"string","description":"The source system that submitted the content. Only `CONTENT_API` is currently supported.","enum":["CONTENT_API"]},"Type":{"type":"string","description":"The type of compliance content in this submission. Only `PAGE` is currently supported.","enum":["PAGE"]},"StartDate":{"type":"string","format":"date-time","description":"The date and time the job started processing, in ISO 8601 format."},"EndDate":{"type":"string","format":"date-time","description":"The date and time the job finished processing, in ISO 8601 format. Empty until the job reaches `COMPLETED`."},"Success":{"type":"integer","description":"The count of content items in the submission that were processed successfully."},"PartialSuccess":{"type":"integer","description":"The count of content items that were processed but reported warnings or non-fatal issues."},"Error":{"type":"integer","description":"The count of content items that failed processing."},"ResponseUri":{"type":"string","description":"The relative URI from which the full per-item results can be retrieved. Available once `Status` is `COMPLETED`."}}},"ErrorResponse":{"type":"object","description":"Standard error response format for the Compliance Content API.","properties":{"Status":{"type":"string","description":"Error status. Returns `ERROR` for failed requests.","enum":["ERROR"]},"Message":{"type":"string","description":"A human-readable description of the error."},"Errors":{"type":"object","description":"Detailed validation errors. Present when the request body fails validation.","properties":{"Error":{"type":"object","properties":{"Field":{"type":"string","description":"The name of the field that failed validation."},"Message":{"type":"string","description":"A description of why the field failed validation."}}}}}}}}}}
```

## Get compliance submission results

> 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.

```json
{"openapi":"3.1.0","info":{"title":"Agency API — Compliance Content","version":"3.0"},"tags":[{"name":"Compliance Content","description":"Submit content for impact.com compliance monitoring and retrieve job status and results."}],"servers":[{"url":"https://api.impact.com","description":"Production"}],"paths":{"/Agencies/{AccountSID}/Compliance/Content/ComplianceAPISubmissions/Response/{Id}":{"get":{"operationId":"getComplianceSubmissionResults","summary":"Get compliance submission results","description":"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`.\n\nThe relative URI is also returned as the `ResponseUri` field in the status response.","tags":["Compliance Content"],"parameters":[{"name":"AccountSID","in":"path","required":true,"description":"Your Agency Account SID.","schema":{"type":"string"}},{"name":"Id","in":"path","required":true,"description":"The submission ID returned in the `QueuedUri` of the create response.","schema":{"type":"string"}}],"responses":{"200":{"description":"Per-item processing results for the submission."},"401":{"description":"Unauthorized. Check that your Account SID and Auth Token are correct."},"404":{"description":"Submission not found."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/agency-v3/reference/compliance/compliance-content.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.