---
title: "Issue a bounded signed live-Catalog identity context for an exact verifier query."
method: POST
path: "/v1/catalog-verifier/identity-contexts"
tags: ["Catalog"]
---

# Issue a bounded signed live-Catalog identity context for an exact verifier query.

`POST /v1/catalog-verifier/identity-contexts`

## Request

- Base URL: `https://api.sourcey.com`
- URL: `https://api.sourcey.com/v1/catalog-verifier/identity-contexts`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- CreateCatalogVerifierIdentityContextRequest
  - `candidate` union, required
    - object
      - `headSha` string, required
      - `kind` 'git_pull_request', required
      - `pullRequestNumber` integer, required
      - `repository` string, required
    - object
      - `candidateDigest` string, required
      - `candidateReference` string, required
      - `kind` 'detached', required
      - `repositoryKind` 'startup-credits' | 'agent-readiness', required
  - `keys` object[], required
    - `candidateIdentityDigest` string
    - `candidateReference` string, required
    - `keyDigest` string, required
    - `kind` 'entity_id' | 'entity_slug' | 'entity_name' | 'domain' | 'entity_url' | 'evidence_url' | 'offer_url' | 'program_id' | 'program_slug' | 'offer_id' | 'offer_slug' | 'semantic_offer', required
    - `normalizedValue` string, required
  - `liveParentReleaseId` string, required
  - `query_contract` 'sourcey.catalog-admission-conflict-query/v1alpha1', required

## Response `200`

Successful response.

- CreateCatalogVerifierIdentityContextResponse200
  - `api_contract` 'sourcey.catalog-api/v1', required
  - `artifact_sha256` string, required
  - `data` object, required
    - `context` object, required
      - `context_contract` 'sourcey.catalog-verifier-identity-context/v1alpha1', required
      - `context_digest` string, required
      - `expires_at` string, date-time, required
      - `issued_at` string, date-time, required
      - `live_parent_release_id` string, required
      - `live_parent_release_sequence` integer, required
      - `protected` object, required
        - `algorithm` 'ed25519', required
        - `key_id` string, required
        - `signature` string, required
        - `signature_purpose` 'catalog-evidence' | 'catalog-identity' | 'catalog-authority' | 'catalog-attestation' | 'catalog-verification' | 'catalog-dispute' | 'catalog-policy' | 'catalog-release' | 'catalog-feed', required
        - `signer_registry_digest` string, required
      - `query_digest` string, required
      - `response_digest` string, required
    - `packet_contract` 'sourcey.catalog-verifier-identity-context-packet/v1alpha1', required
    - `query` object, required
      - `candidate` union, required
        - object
          - `headSha` string, required
          - `kind` 'git_pull_request', required
          - `pullRequestNumber` integer, required
          - `repository` string, required
        - object
          - `candidateDigest` string, required
          - `candidateReference` string, required
          - `kind` 'detached', required
          - `repositoryKind` 'startup-credits' | 'agent-readiness', required
      - `keys` object[], required
        - `candidateIdentityDigest` string
        - `candidateReference` string, required
        - `keyDigest` string, required
        - `kind` 'entity_id' | 'entity_slug' | 'entity_name' | 'domain' | 'entity_url' | 'evidence_url' | 'offer_url' | 'program_id' | 'program_slug' | 'offer_id' | 'offer_slug' | 'semantic_offer', required
        - `normalizedValue` string, required
      - `liveParentReleaseId` string, required
      - `query_contract` 'sourcey.catalog-admission-conflict-query/v1alpha1', required
    - `response` object, required
      - `matches` object[], required
        - `keyDigest` string, required
        - `source` union, required
          - object
            - `kind` 'current_catalog', required
            - `liveParentReleaseId` string, required
          - object
            - `headSha` string, required
            - `kind` 'open_pull_request', required
            - `pullRequestNumber` integer, required
            - `repository` string, required
          - object
            - `kind` 'pending_git_lineage', required
            - `liveSourceCommit` string, required
            - `repository` string, required
            - `targetCommit` string, required
          - object
            - `candidateDigest` string, required
            - `candidateReference` string, required
            - `kind` 'pending_submission', required
        - `targetIdentityDigest` string
        - `targetReference` string, required
      - `query_digest` string, required
      - `response_contract` 'sourcey.catalog-admission-conflict-response/v1alpha1', required
      - `response_digest` string, required
    - `signer_registry` object, required
      - `generation` integer, required
      - `issuers` object[], required
        - `issuer_id` string, required
        - `keys` object[], required
          - `algorithm` 'ed25519', required
          - `compromised_after_sequence` integer
          - `key_id` string, required
          - `public_key_pem` string, required
          - `purposes` string[], required
          - `valid_from` string, date-time, required
          - `valid_until` string, date-time
      - `parent_registry_digest` string, nullable, required
      - `registry_contract` 'sourcey.signer-registry/v1alpha1', required
      - `registry_digest` string, required
      - `root_signatures` object[], required
        - `algorithm` 'ed25519', required
        - `key_id` string, required
        - `signature` string, required
  - `release_id` string, required

## Other responses

- `400`: Invalid request.
- `401`: HTTP 401 response.
- `403`: HTTP 403 response.
- `405`: HTTP 405 response.
- `409`: HTTP 409 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)