# Get Results

`GET /api/session/{internal_session_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 [content check](https://whitecircle.com/docs/2026-04-15/session/check-session.md). You can look up a session either by its internal ID path or by your external ID query. Both lookup styles return the same `{ session, artifacts }` envelope as `POST /api/session`.

## Route Shapes

Use one of these routes:

| Route | Use when |
| ----- | -------- |
| `GET /api/session/{internal_session_id}` | You have the system-generated session ID from a previous response |
| `GET /api/session?external_session_id=...` | You want to look up the latest matching session by your own external ID |

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

> [!NOTE]
> `GET /api/session?external_session_id=...` returns the most recently submitted matching session within the same deployment.

## Example Requests

Using the internal session ID:

```bash
curl -X GET "https://eu.whitecircle.com/api/session/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer wc-your-api-key" \
  -H "whitecircle-version: 2026-04-15"
```

Using your external session ID:

```bash
curl -X GET "https://eu.whitecircle.com/api/session?external_session_id=user-session-123" \
  -H "Authorization: Bearer wc-your-api-key" \
  -H "whitecircle-version: 2026-04-15"
```

## Response

The endpoint returns the same session envelope as `POST /api/session`:

* `session` — The session-level verdict, IDs, and policy statuses
* `artifacts` — The artifact result objects for content associated with that session response

> [!TIP]
> If you provided an `external_session_id` during the original check, you can use it for stable lookups across systems. If you need an exact immutable lookup target, store the returned `internal_session_id`.

## 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_session_id` (`string`, required): Find a session by its internal session ID.

## Query Parameters

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

## Request example

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

## Response

### 200

Success

`application/json`

- `session` (`object`, required)
- `session.flagged` (`boolean`, required)
- `session.internal_session_id` (`string`, required)
- `session.policies` (`object`, required)
- `session.policies.{key}` (`object`, optional)
- `session.policies.{key}.flagged` (`boolean`, required)
- `session.policies.{key}.flagged_source` (`enum<string>[]`, required): Available options: `text`, `image`.
- `session.policies.{key}.name` (`string`, required)
- `session.external_session_id` (`string | null`, optional)
- `session.note` (`string | null`, optional)
- `artifacts` (`object[]`, required)
- `artifacts.policies` (`object`, required)
- `artifacts.policies.{key}` (`object`, optional)
- `artifacts.policies.{key}.flagged` (`boolean`, required)
- `artifacts.policies.{key}.flagged_source` (`string[]`, required)
- `artifacts.policies.{key}.name` (`string`, required)
- `artifacts.kind` (`string`, required)
- `artifacts.status` (`string`, required)
- `artifacts.internal_artifact_id` (`string`, required)
- `artifacts.flagged` (`boolean | null`, optional)
- `artifacts.updated_at` (`string | null`, optional)
- `artifacts.external_artifact_id` (`string | null`, optional)
- `artifacts.external_session_id` (`string | null`, optional)
- `artifacts.internal_session_id` (`string | null`, optional)
- `artifacts.created_at` (`string | null`, optional)
- `artifacts.note` (`string | null`, optional)

**Example**

```json
{
  "session": {
    "flagged": true,
    "internal_session_id": "123e4567-e89b-12d3-a456-426614174000",
    "external_session_id": "user-session-001",
    "policies": {
      "70289e06-9111-463e-b121-7247c2b7bfbd": {
        "flagged": true,
        "flagged_source": [
          "text"
        ],
        "name": "No PII Sharing"
      }
    }
  },
  "artifacts": [
    {
      "flagged": true,
      "policies": {
        "70289e06-9111-463e-b121-7247c2b7bfbd": {
          "flagged": true,
          "flagged_source": [
            "image"
          ],
          "name": "No PII Sharing"
        }
      },
      "kind": "image",
      "status": "completed",
      "updated_at": "2026-04-15T12:00:00Z",
      "internal_artifact_id": "223e4567-e89b-12d3-a456-426614174000",
      "external_artifact_id": "artifact-001",
      "external_session_id": "user-session-001",
      "internal_session_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2026-04-15T12:00:00Z"
    }
  ]
}
```

### 400

Bad Request
