---
title: "Pre-install check: give ?hash=<sha256>, ?url=<endpoint or package URL> or ?slug=<slug>; answers known listing, vetting tier, revoked or unknown."
method: GET
path: "/v1/store/check"
tags: ["Store"]
---

# Pre-install check: give ?hash=<sha256>, ?url=<endpoint or package URL> or ?slug=<slug>; answers known listing, vetting tier, revoked or unknown.

`GET /v1/store/check`

## Request

- Base URL: `https://www.rightshold.com`
- URL: `https://www.rightshold.com/v1/store/check`
- Auth: none required

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object: Inferred from 9 recorded responses; required fields appeared in every one; additional properties may appear.
  - `query` object, required
    - `hash` string
    - `url` string
    - `slug` string
  - `found` boolean, required
  - `verdict` string, required
  - `safe_to_install` boolean, nullable, required
  - `listing` object, nullable, required
    - `slug` string
    - `type` string
    - `name` string
    - `summary` string
    - `version` string
    - `tier` string
    - `tier_label` string
    - `status` string
    - `publisher` object
      - `name` string, required
      - `first_party` boolean, required
      - `agent_id` string, nullable, required
      - `handle` string, nullable, required
      - `kya_level` string, nullable, required
    - `endpoint_url` string, nullable
    - `package_url` string, nullable
    - `artifact_hash` string, nullable
    - `permissions` object
      - `network` string[], required
      - `filesystem` string, required
      - `credentials` string, required
      - `env` string[]
    - `ratings` object
      - `count` integer, required
      - `average` unknown, required
    - `store_url` string
    - `updated_at` string
    - `description` string
    - `checks` object
      - `domain_proof` object
        - `status` string, required
        - `detail` string, required
      - `package_hash` object
        - `status` string, required
        - `detail` string, required
      - `permissions_declared` object, required
        - `status` string, required
        - `detail` string, required
      - `manifest_signature` object, required
        - `status` string, required
        - `detail` string, required
      - `endpoint_liveness` object
        - `status` string, required
        - `detail` string, required
      - `publisher_kya` object
        - `status` string, required
        - `detail` string, required
    - `created_at` string
  - `scan` object
    - `status` string, required
    - `standing_flag_ids` string[], required
    - `note` string, required
  - `note` string, required
  - `superseded` object
    - `version` string, required
    - `current_version` string, required
    - `current_hash` string, required

## Other responses

- `400`: Problem details: a stable error code, type URI, title, status and an explanation
- `401`: Problem details: a stable error code, type URI, title, status and an explanation
- `404`: Problem details: a stable error code, type URI, title, status and an explanation
- `405`: Problem details: a stable error code, type URI, title, status and an explanation
- `422`: Problem details: a stable error code, type URI, title, status and an explanation
- `429`: Request budget exhausted; retry after Retry-After seconds
- `500`: Problem details: a stable error code, type URI, title, status and an explanation
- `4XX`: {error, detail}

---

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