---
title: "Read aggregate validation, admission, and publication state for a submission."
method: GET
path: "/v1/submissions/{submission_id}"
tags: ["Catalog"]
---

# Read aggregate validation, admission, and publication state for a submission.

`GET /v1/submissions/{submission_id}`

## Request

- Base URL: `https://api.sourcey.com`
- URL: `https://api.sourcey.com/v1/submissions/{submission_id}`
- Auth: one of:
  - API key in cookie `sourcey_session`
  - HTTP bearer

## Path parameters

- `submission_id` string, required

## Response `200`

Successful response.

- CreateCatalogSubmissionResponse202
  - `api_contract` 'sourcey.catalog-api/v1', required
  - `artifact_sha256` string, required
  - `data` union, required
    - object
      - `authentication_digest` string, required
      - `change_set_digest` string, nullable, required
      - `created_at` string, date-time, required
      - `ingress` 'authenticated_form' | 'paid_agent' | 'catalog_operator' | 'governed_ops', required
      - `links` object, required
        - `self` string, required
      - `live_parent_release_id` string, required
      - `payload_digest` string, required
      - `product` 'catalog_record', required
      - `proposal_digest` string, nullable, required
      - `publication_release_id` string, nullable, required
      - `stages` object[], required
        - `diagnostics` object[], required
          - `code` string, required
          - `message` string, required
          - `path` string
          - `stage` 'validation' | 'evidence' | 'identity' | 'readiness' | 'authorization' | 'publication' | 'readback', required
        - `stage` 'validation' | 'evidence' | 'identity' | 'readiness' | 'authorization' | 'publication' | 'readback', required
        - `status` 'pending' | 'passed' | 'failed' | 'not_required' | 'invalidated', required
      - `state` 'queued' | 'active' | 'awaiting_review' | 'awaiting_admission' | 'awaiting_authorization' | 'rejected' | 'invalidated' | 'published', required
      - `submission_id` string, required
      - `telemetry` object, required
        - `active_ms` integer, required
        - `cache_reuse` object, required
          - `created` integer, required
          - `reused` integer, required
        - `closure_cardinality` integer, required
        - `live_readback_ms` integer, nullable, required
        - `queued_ms` integer, required
        - `stages_invoked` string[], required
      - `updated_at` string, date-time, required
    - object
      - `authoring_blob_digest` string, nullable, required
      - `created_at` string, date-time, required
      - `diagnostics` object[], required
        - `code` 'required' | 'invalid' | 'ambiguous_identity' | 'cross_entity_offer' | 'base_authoring_mismatch', required
        - `message` string, required
        - `path` string, starts_with, required
      - `ingress` 'authenticated_form' | 'paid_agent' | 'catalog_operator' | 'governed_ops', required
      - `links` object, required
        - `self` string, required
      - `payload_digest` string, required
      - `product` 'agent_readiness', required
      - `state` 'queued' | 'admitted' | 'refused', required
      - `subject` object, nullable, required
        - `declaration_ids` string[], required
        - `entity_id` string, required
      - `submission_id` string, required
      - `updated_at` string, date-time, required
  - `release_id` string, required

## Other responses

- `400`: Invalid request.
- `401`: HTTP 401 response.
- `403`: HTTP 403 response.
- `404`: Resource not found.
- `405`: HTTP 405 response.
- `429`: HTTP 429 response.
- `500`: HTTP 500 response.
- `503`: HTTP 503 response.

---

[API](https://skmtc.dev/sourcey/apis/sourcey-public-api.md) · [All operations](https://skmtc.dev/sourcey/apis/sourcey-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sourcey/apis/sourcey-public-api/revisions/437166b51fa5?raw)