Single creative result

<Note> We recommend using the [Push Result API](/advertising/reference/push-result-api-overview) to let HUMAN push results to your webhook endpoint instead of the Pulling API whenever possible. This is because the Push Result API: * Lets HUMAN end you results in close to real time * Lets you receive both Ad Quality results as soon as they are ready * Lets you receive Malvertising threats as soon as HUMAN flags them However, if your organization cannot use the Push Result API, you can use the Pulling API as an alternative to receive analysis results. HUMAN will provide the `HUMAN-API-URL` and `X-API-KEY` during the integration process. </Note> Provides results for a single creative submitted via the [Creative Submission API](/advertising/reference/submit-request). A successful response depends on whether HUMAN finished our analysis. * If we've finished analyzing: The response will include the full results of our analysis. * If we haven't finished analyzing: The response will only include basic information about the creative's status.

Authentication

X-API-KEYstring
Your unique Ad Quality API key.

Path Parameters

creative_idstringRequired
The creative ID which is equal to the ID submitted for creative analysis.

Response

Request submitted properly
statusenum or null

Creative processing status - the creative’s status in HUMAN’s processing queue. Hover over each status for details.

Allowed values:
adobject or null

An IAB-compliant object that follows the structure outlined in the IAB’s AdCom specification.

Errors