# Get Artifact Results

`GET /api/artifact/{internal_artifact_id}`

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

OpenAPI: [latest/openapi.json](https://whitecircle.com/docs/latest/openapi.json)

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

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

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

## 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
