# Get Artifact Results

`GET /api/artifact/{internal_artifact_id}`

Base URLs: `https://eu.whitecircle.com`, `https://us.whitecircle.com`

OpenAPI: [2026-04-15/openapi.json](https://whitecircle.com/docs/2026-04-15/openapi.json)

Retrieve the results of a previously submitted [artifact check](https://whitecircle.com/docs/2026-04-15/artifact/check-artifact.md). 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 |

`deployment_id` remains optional on both routes. If you omit it, White Circle uses the deployment associated with your API key.

> [!TIP]
> For exact immutable lookups, prefer `internal_artifact_id` over `external_artifact_id`.

> [!NOTE]
> When multiple artifacts share the same `external_artifact_id`, White Circle returns the latest artifact version within the same deployment.

## Example Requests

Using the internal artifact ID:

```bash
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:

```bash
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

| Field                   | Type            | Description                                                                                 |
| ----------------------- | --------------- | ------------------------------------------------------------------------------------------- |
| `flagged`               | boolean \| null | `true` if any policy was violated. `null` while processing or on failure.                   |
| `policies`              | object          | Map of policy IDs to their violation statuses                                                |
| `kind`                  | string          | Content type of the artifact (e.g., `"image"`)                                               |
| `status`                | string          | Check status: `"completed"`, `"processing"`, or `"failed"`                                   |
| `updated_at`            | string          | ISO 8601 last update timestamp                                                               |
| `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)                                    |
| `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:

* `name` — Human-readable policy name
* `flagged` — Whether this specific policy was violated
* `flagged_source` — Array of content types that triggered the violation (e.g., `["image"]`)

## Authorizations

- `Authorization` (`string`, header, required): API Key required. Format: Bearer wc-your-api-key.

## Headers

- `whitecircle-version` (`string`, required): API Version. Example: `"2026-04-15"`.

## Path Parameters

- `internal_artifact_id` (`string`, required): Find an artifact by its internal artifact ID.

## Query Parameters

- `deployment_id` (`string`, optional): Optional deployment ID to validate artifact ownership.

## Request example

```bash
curl --request GET \
  --url 'https://eu.whitecircle.com/api/artifact/<internal_artifact_id>' \
  --header "Authorization: Bearer $WHITECIRCLE_API_KEY" \
  --header 'whitecircle-version: 2026-04-15'
```

## Response

### 200

Success

`application/json`

- `policies` (`object`, required)
- `policies.{key}` (`object`, optional)
- `policies.{key}.flagged` (`boolean`, required)
- `policies.{key}.flagged_source` (`string[]`, required)
- `policies.{key}.name` (`string`, required)
- `kind` (`string`, required)
- `status` (`string`, required)
- `internal_artifact_id` (`string`, required)
- `flagged` (`boolean | null`, optional)
- `updated_at` (`string | null`, optional)
- `external_artifact_id` (`string | null`, optional)
- `external_session_id` (`string | null`, optional)
- `internal_session_id` (`string | null`, optional)
- `created_at` (`string | null`, optional)
- `note` (`string | null`, optional)

**Example**

```json
{
  "policies": {
    "<key>": {
      "flagged": true,
      "flagged_source": [
        "<string>"
      ],
      "name": "<string>"
    }
  },
  "kind": "<string>",
  "status": "<string>",
  "internal_artifact_id": "<string>",
  "flagged": true,
  "updated_at": "<string>",
  "external_artifact_id": "<string>",
  "external_session_id": "<string>",
  "internal_session_id": "<string>",
  "created_at": "<string>",
  "note": "<string>"
}
```

### 400

Bad Request
