index

Searches index by entry metadata

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.

post/api/v1/index/retrieve

Request body

emailstring email

subjectstring

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.

hashstring

operator'and' | 'or'

Response

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

string[] required

Changes

Changed in 2 of the 50 revisions of this API.2

Sep 23, 202280c238d1b68f1See the full diff
- ○
  endpoint deprecated
  endpoint-deprecated
Jan 28, 2021a6c8f19ce1c31See the full diff
- ○
  endpoint reactivated
  endpoint-reactivated

Full history