---
title: "Searches index by entry metadata"
method: POST
path: "/api/v1/index/retrieve"
tags: ["index"]
deprecated: true
---

# Searches index by entry metadata

`POST /api/v1/index/retrieve`

> **Deprecated.**

EXPERIMENTAL - this endpoint is offered as best effort only and may be changed or removed in future releases.
The results returned from this endpoint may be incomplete.

## Request body

- SearchIndex
  - `email` string, email
  - `subject` string — A SAN value (URI, DNS, IP, OtherName) as stored on the entry. Lookup is case-insensitive — e.g. a GitHub OIDC SAN such as `https://github.com/owner/repo/.github/workflows/build.yml@refs/heads/main`.
  - `publicKey` object
    - `format` 'pgp' | 'x509' | 'minisign' | 'ssh' | 'tuf', required
    - `content` string, byte
  - `hash` string
  - `operator` 'and' | 'or'

## Response `200`

Returns zero or more entry UUIDs from the transparency log based on search query

- string[]

## Other responses

- `400` — The content supplied to the server was invalid
- `default` — There was an internal error in the server while processing the request

## Changes

- **2022-09-23** `80c238d1b68f` — 1 info
  - endpoint deprecated
- **2021-01-28** `a6c8f19ce1c3` — 1 info
  - endpoint reactivated

[Change history](https://skmtc.dev/sigstore/apis/rekor/changes/api/v1/index/retrieve/post.md)

---

[API](https://skmtc.dev/sigstore/apis/rekor.md) · [All operations](https://skmtc.dev/sigstore/apis/rekor/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sigstore/rekor/revisions/35007e4582f4/schema)