> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whitecircle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Artifact Results

Retrieve the results of a previously submitted [artifact check](/latest/artifact/check-artifact). 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:

| Route                                        | Use when                                                           |
| -------------------------------------------- | ------------------------------------------------------------------ |
| `GET /api/artifact/{internal_artifact_id}`   | You have the system-generated Artifact ID from a previous response |
| `GET /api/artifact?external_artifact_id=...` | You want the latest Artifact version for your external ID          |

`environment_id` remains optional on both routes. If you omit it, White Circle uses the Environment associated with your API key. The legacy `deployment_id` parameter is deprecated but still accepted as a predecessor of `environment_id`.

<Tip>For exact immutable lookups, prefer `internal_artifact_id` over `external_artifact_id`.</Tip>

<Info>When multiple Artifacts share the same `external_artifact_id`, White Circle returns the latest artifact version within the same Environment.</Info>

## Example Requests

Using the internal Artifact ID:

```bash theme={null}
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-06-01"
```

Using your external Artifact ID:

```bash theme={null}
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-06-01"
```

## Response Overview

| Field                  | Type            | Description                                                                      |
| ---------------------- | --------------- | -------------------------------------------------------------------------------- |
| `flagged`              | boolean \| null | `true` if any Policy was violated. `null` while processing or on failure.        |
| `status`               | string          | Check status: `"completed"`, `"processing"`, or `"failed"`                       |
| `policies`             | object          | Map of Policy IDs to their violation statuses                                    |
| `kind`                 | string          | Content type of the Artifact (e.g., `"image"`)                                   |
| `internal_artifact_id` | string          | System-generated UUID for this Artifact                                          |
| `external_artifact_id` | string          | Your custom Artifact tracking ID (if provided)                                   |
| `external_session_id`  | string          | External ID of the linked session (if attached)                                  |
| `internal_session_id`  | string          | System-generated UUID of the linked session (if attached)                        |
| `updated_at`           | string          | ISO 8601 last update timestamp                                                   |
| `created_at`           | string          | ISO 8601 creation timestamp                                                      |
| `note`                 | string          | Informational message, included when applicable (e.g. why an image fetch failed) |

Each Policy in the `policies` object includes:

* `flagged` — Whether this specific Policy was violated
* `name` — Human-readable Policy name
* `enabled_by_conditions` — The Conditions that selected this Policy, which is why it was evaluated. Absent when no Condition was involved.


## OpenAPI

````yaml GET /api/artifact/{internal_artifact_id}
openapi: 3.1.0
info:
  title: WhiteCircle API Backend
  description: 'Authentication: Bearer API Key Required'
  license:
    name: ''
  version: '2026-04-15'
servers:
  - url: https://eu.whitecircle.com
  - url: https://us.whitecircle.com
security: []
tags:
  - name: Session
    description: Session-based content checking and moderation
  - name: User
    description: User risk assessment and scoring
  - name: Policy
    description: Policy management CRUD
  - name: Metric
    description: Metric management CRUD
  - name: Artifact
    description: Standalone artifact moderation
paths:
  /api/artifact/{internal_artifact_id}:
    get:
      tags:
        - Artifact
      operationId: artifact_get_by_id_v4
      parameters:
        - name: whitecircle-version
          in: header
          description: API Version
          required: true
          schema:
            type: string
          example: '2026-04-15'
        - name: internal_artifact_id
          in: path
          description: Find an artifact by its internal artifact ID
          required: true
          schema:
            type: string
        - name: deployment_id
          in: query
          description: Optional deployment ID to validate artifact ownership
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtifactCheckResponse'
        '400':
          description: Bad Request
      security:
        - bearerAuth: []
components:
  schemas:
    ArtifactCheckResponse:
      type: object
      required:
        - status
        - kind
        - internal_artifact_id
        - policies
      properties:
        flagged:
          type:
            - boolean
            - 'null'
        policies:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ArtifactPolicyStatus'
          propertyNames:
            type: string
        kind:
          type: string
        status:
          type: string
        updated_at:
          type:
            - string
            - 'null'
        internal_artifact_id:
          type: string
        external_artifact_id:
          type:
            - string
            - 'null'
        external_session_id:
          type:
            - string
            - 'null'
        internal_session_id:
          type:
            - string
            - 'null'
        created_at:
          type:
            - string
            - 'null'
        note:
          type:
            - string
            - 'null'
    ArtifactPolicyStatus:
      type: object
      required:
        - flagged
        - flagged_source
        - name
      properties:
        flagged:
          type: boolean
        flagged_source:
          type: array
          items:
            type: string
        name:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'API Key required. Format: Bearer wc-your-api-key'

````