---
title: "Resolve a published agent readiness profile by immutable entity and exact scope keys."
method: GET
path: "/v1/entities/{entity}/agent-readiness-profiles/{product}/{job}"
tags: ["Catalog"]
---

# Resolve a published agent readiness profile by immutable entity and exact scope keys.

`GET /v1/entities/{entity}/agent-readiness-profiles/{product}/{job}`

## Request

- Base URL: `https://api.sourcey.com`
- URL: `https://api.sourcey.com/v1/entities/{entity}/agent-readiness-profiles/{product}/{job}`
- Auth: one of:
  - none
  - HTTP bearer

## Path parameters

- `entity` string, required
- `job` string, required
- `product` string, required

## Response `200`

Successful response.

- GetEntityAgentReadinessProfileResponse200
  - `api_contract` 'sourcey.catalog-api/v1', required
  - `artifact_sha256` string, required
  - `data` union, required
    - object
      - `agent_readiness_profile_id` string, required
      - `canonical_url` string, uri, required
      - `catalog_binding` object, required
        - `base_release_id` string, required
        - `entity_revision_digest` string, required
      - `declaration` union, required
        - object
          - `status` 'none', required
        - object
          - `declaration_id` string, required
          - `provenance` union, required
            - object
              - …
            - object
              - …
          - `status` 'community_declared' | 'entity_attested', required
      - `declaration_revision_digest` string, required
      - `discovery` object[], required
        - `adapter` object, required
          - `namespace` string, required
          - `version` string, required
        - `attempt_digest` string, required
        - `descriptor_url` string, uri, required
        - `fact` 'mcp_endpoint' | 'openapi_server' | 'oauth_protected_resource' | 'oauth_authorization_server' | 'ard_entry' | 'api_catalog_link' | 'agent_documentation' | 'agent_skill' | 'payment_manifest' | 'documentation_route' | 'unsupported_descriptor', required
        - `value` string, uri, required
      - `discovery_run_at` string, date-time, nullable, required
      - `effective_from` string, date-time, required
      - `effective_until` string, date-time
      - `entity_id` string, required
      - `grade` object, required
        - `approvals` string[], required
        - `job` 'reachable' | 'verified' | 'unavailable', required
        - `letter` 'A+' | 'A' | 'B+' | 'B' | 'C' | 'D' | 'F', required
        - `statement` string, required
        - `steps` object[], required
          - `outcome` 'machine' | 'not_applicable' | 'approval' | 'workaround' | 'gated' | 'not_assessed', required
          - `step` 'discover' | 'authority' | 'onboard' | 'pay' | 'confirm' | 'sustain', required
          - `timing` 'setup' | 'recurring', nullable, required
        - `workarounds` object[], required
          - `step` 'discover' | 'authority' | 'onboard' | 'pay' | 'confirm' | 'sustain', required
          - `timing` 'setup' | 'recurring', required
      - `interface_id` string, nullable, required
      - `job` object, required
        - `category` string, required
        - `job_digest` string, required
        - `job_id` string, required
        - `name` string, required
        - `statement` string, required
      - `label` 'vendor_run_verified' | 'probed', required
      - `label_run_at` string, date-time, nullable, required
      - `last_run_at` string, date-time, required
      - `lifecycle` 'active' | 'paused' | 'ended' | 'withdrawn', required
      - `policy_as_of` string, date-time, required
      - `policy_digest` string, required
      - `policy_version` string, required
      - `projection_contract` 'sourcey.agent-readiness-projection/v1alpha1', required
      - `projection_digest` string, required
      - `provenance` object, required
        - `basis_event_ids` string[], required
        - `dispute` 'none' | 'open' | 'resolved', required
        - `vendor_attestation` union, required
          - object
            - `status` 'none', required
          - object
            - `attested_at` string, date-time, required
            - `event_id` string, required
            - `status` 'current', required
      - `publication` object, required
        - `reasons` string[], required
        - `visibility` 'discoverable' | 'resolvable_only' | 'private', required
      - `revision_digest` string, required
      - `run` object, required
        - `assertions` object[], required
          - `assertion` string, required
          - `failure` object, nullable, required
            - `check` integer, required
            - `reason` string, required
          - `holds` boolean, required
          - `statement` string, required
        - `discovery_reads` integer, required
        - `exchanges` object[], required
          - `exchange_digest` string, required
          - `finished_at` string, date-time, required
          - `method` 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', required
          - `purpose` 'delegation' | 'job' | 'cleanup' | 'probe_operation' | 'probe_malformed' | 'probe_resource_metadata' | 'probe_authorization_server' | 'probe_client_registration' | 'probe_authorization' | 'probe_page', required
          - `response` object, nullable, required
            - `content_bytes` integer, required
            - `content_digest` string, required
            - `media_type` string, required
            - `status` integer, required
          - `role` 'request' | 'session_opening' | 'tool_listing' | 'session_close', required
          - `started_at` string, date-time, required
          - `transport_error` string, nullable, required
          - `url` string, uri, required
        - `finished_at` string, date-time, required
        - `started_at` string, date-time, required
      - `scope` object, required
        - `job` object, required
          - `key` string, required
          - `name` string, required
        - `product` object, required
          - `key` string, required
          - `name` string, required
      - `surface_catalog` object, required
        - `endpoints` object[], required
          - `allowed_redirect_hosts` string[]
          - `endpoint_id` string, required
          - `operated_by_participant_id` string, required
          - `roles` string[], required
          - `standard_bindings` object[], required
            - `namespace` string, required
            - `relation` 'declares' | 'describes' | 'implements' | 'uses', required
            - `version` string, required
          - `transport` 'http' | 'websocket' | 'grpc', required
          - `uri` string, uri, required
        - `interfaces` object[], required
          - `endpoint_ids` string[], required
          - `functions` string[], required
          - `interface_id` string, required
          - `modality` 'web_application' | 'network_api' | 'command_line' | 'software_library' | 'tool_server' | 'agent_service', required
          - `operated_by_participant_id` string, required
          - `resource_ids` string[], required
          - `standard_bindings` object[], required
            - `namespace` string, required
            - `relation` 'declares' | 'describes' | 'implements' | 'uses', required
            - `version` string, required
        - `participants` object[], required
          - `identity` union, required
            - object
              - …
            - object
              - …
          - `participant_id` string, required
          - `roles` string[], required
        - `relations` object[], required
          - `from` object, required
            - `node_id` string, required
            - `node_kind` 'resource' | 'endpoint' | 'interface' | 'surface_exclusion', required
          - `kind` 'describes' | 'authenticates' | 'requires' | 'alternative_to' | 'precedes', required
          - `relation_id` string, required
          - `to` object, required
            - `node_id` string, required
            - `node_kind` 'resource' | 'endpoint' | 'interface' | 'surface_exclusion', required
        - `resources` object[], required
          - `allowed_redirect_hosts` string[]
          - `operated_by_participant_id` string, required
          - `resource_id` string, required
          - `roles` string[], required
          - `standard_bindings` object[], required
            - `namespace` string, required
            - `relation` 'declares' | 'describes' | 'implements' | 'uses', required
            - `version` string, required
          - `uri` string, uri, required
        - `surface_exclusions` object[], required
          - `exclusion_id` string, required
          - `rationale` string, required
          - `role` 'discovery' | 'terms' | 'eligibility' | 'pricing' | 'access' | 'checkout' | 'provisioning' | 'operations' | 'recovery' | 'authentication' | 'descriptor' | 'documentation' | 'policy' | 'status', required
    - union
      - object
        - `agent_readiness_profile_id` string, required
        - `canonical_agent_readiness_profile_id` string, required
        - `event_id` string, required
        - `kind` 'agent_readiness_profile_tombstone', required
        - `transition` 'merged', required
      - object
        - `agent_readiness_profile_id` string, required
        - `kind` 'agent_readiness_profile_tombstone', required
        - `transition` 'retired', required
  - `freshness` object, 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)