Retrieve artifact check results by internal_artifact_id or external_artifact_id.
Retrieve the results of a previously submitted artifact check. Use this endpoint to look up artifact policy check results using either the system-generated ID or your custom tracking identifier.
Query Parameters
*Exactly one of internal_artifact_id or external_artifact_id is required.
Example Requests
Using the internal artifact ID:
cURL
curl -X GET "https://eu.whitecircle.com/api/artifact/get_by_id?internal_artifact_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "Authorization: Bearer wc-your-api-key" \
-H "whitecircle-version: 2025-12-01"Using your external artifact ID:
cURL
curl -X GET "https://eu.whitecircle.com/api/artifact/get_by_id?external_artifact_id=user-avatar-42" \
-H "Authorization: Bearer wc-your-api-key" \
-H "whitecircle-version: 2025-12-01"Response Overview
Each policy in the policies object includes:
name— Human-readable policy nameflagged— Whether this specific policy was violatedflagged_source— Array of content types that triggered the violation (e.g.,["image"])
Authorizations
Headers
Query Parameters
Response
Artifact found
Artifact check result.
statusstringrequiredCheck status: "completed"
policiesobjectrequiredMap of policy ID to violation result
Show child attributesHide child attributes
internal_artifact_idstringrequiredSystem-generated UUID for this artifact
kindstringrequiredEcho of content.kind from request
flaggedboolean | nulltrue if any policy was violated
external_artifact_idstring | nullYour custom artifact ID (if provided)
internal_session_idstring | nullInternal ID of the linked session (if attached)
external_session_idstring | nullExternal ID of the linked session (if provided)
created_atstring | nullISO 8601 creation timestamp
updated_atstring | nullISO 8601 last update timestamp
notestring | nullInformational note (only present when applicable)
Bad Request