GET
Retrieve the results of a previously submitted artifact check. You can look up an artifact either by its internal ID path or by your external ID query.
Route Shapes
Use one of these routes:
deployment_id remains optional on both routes. If you omit it, White Circle uses the deployment associated with your API key.
Example Requests
Using the internal artifact ID:
cURL
curl -X GET "https://eu.whitecircle.com/api/artifact/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "Authorization: Bearer wc-your-api-key" \
-H "whitecircle-version: 2026-04-15"Using your external artifact ID:
cURL
curl -X GET "https://eu.whitecircle.com/api/artifact?external_artifact_id=user-avatar-42" \
-H "Authorization: Bearer wc-your-api-key" \
-H "whitecircle-version: 2026-04-15"Example Response
JSON
{
"flagged": true,
"policies": {
"4d7543e2-d106-4cac-b0a4-87b27e473813": {
"name": "No Explicit Content",
"flagged": true,
"flagged_source": ["image"]
},
"d54a96f1-ccac-4967-9101-46e68eab415e": {
"name": "No Violence",
"flagged": false,
"flagged_source": []
}
},
"kind": "image",
"status": "completed",
"updated_at": "2026-04-15T10:30:00Z",
"internal_artifact_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"external_artifact_id": "user-avatar-42",
"external_session_id": "user-session-123",
"internal_session_id": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2026-04-15T10:30:00Z",
"note": null
}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
Path Parameters
Query Parameters
Response
application/json
Success
Bad Request