Sessions

Get Results

GET
/api/session/{internal_session_id}

Retrieve the results of a previously submitted content check. 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:

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

Example Requests

Using the internal session ID:

cURL

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:

cURL

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

Authorizations

  • Authorizationstringheaderrequired

    API Key required. Format: Bearer wc-your-api-key

Headers

  • whitecircle-versionstringrequired

    API Version

    Example: "2026-04-15"

Path Parameters

  • internal_session_idstringrequired

    Find a session by its internal session ID

Query Parameters

  • deployment_idstring

    Optional deployment ID to validate session ownership

Response

application/json

Success

  • sessionobjectrequired

    Show child attributes
    • session.flaggedbooleanrequired

    • session.internal_session_idstringrequired

    • session.policiesobjectrequired

      Show child attributes
      • session.policies.{key}object

        Show child attributes
        • session.policies.{key}.flaggedbooleanrequired

        • session.policies.{key}.flagged_sourceenum<string>[]required

          Available options: text, image

        • session.policies.{key}.namestringrequired

    • session.external_session_idstring | null

    • session.notestring | null

  • artifactsobject[]required

    Show child attributes
    • artifacts.policiesobjectrequired

      Show child attributes
      • artifacts.policies.{key}object

        Show child attributes
        • artifacts.policies.{key}.flaggedbooleanrequired

        • artifacts.policies.{key}.flagged_sourcestring[]required

        • artifacts.policies.{key}.namestringrequired

    • artifacts.kindstringrequired

    • artifacts.statusstringrequired

    • artifacts.internal_artifact_idstringrequired

    • artifacts.flaggedboolean | null

    • artifacts.updated_atstring | null

    • artifacts.external_artifact_idstring | null

    • artifacts.external_session_idstring | null

    • artifacts.internal_session_idstring | null

    • artifacts.created_atstring | null

    • artifacts.notestring | null