---
title: "Semantic credential search"
method: GET
path: "/ai/search"
tags: ["AI Intelligence"]
---

# Semantic credential search

`GET /ai/search`

## Request

- Base URL: `https://app.arkova.ai/api/v1`
- URL: `https://app.arkova.ai/api/v1/ai/search`
- Auth: HTTP bearer

Search credentials using natural language via pgvector similarity. Costs 1 AI credit. Gated by ENABLE_SEMANTIC_SEARCH flag.

## Query parameters

- `q` string, required
- `threshold` number
- `limit` integer

## Response `200`

Search results with similarity scores

- SearchResponse
  - `results` object[]
    - `anchor_id` string, uuid
    - `public_id` string
    - `label` string
    - `credential_type` string
    - `issuer_name` string
    - `similarity` number
  - `total` integer
  - `query` string
  - `threshold` number

## Other responses

- `401`: Authentication required
- `402`: Insufficient AI credits
- `429`: Rate limit exceeded
- `503`: API not enabled (feature flag off)

---

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