<!-- source: https://docs.redpine.ai/docs/api-reference -->
# API reference

> Every public endpoint, with full parameter and response detail.

Generated straight from the OpenAPI spec: every request parameter, response field, and status code for each endpoint. For a narrative walkthrough instead, start at [Get started](/) or [Which search endpoint?](/docs/search-endpoints).

<Cards>
  <Card title="Search documents" href="/docs/api-reference/search/searchQuery">
    The core endpoint: run a search and get billed, ranked results back.
  </Card>

  <Card title="Search a single collection by name" href="/docs/api-reference/search/searchCollection">
    Shorthand for search with the collection named in the path instead of the body.
  </Card>

  <Card title="Preview search results without charging" href="/docs/api-reference/search/searchPreview">
    Same pipeline as search, free, returns teaser rows and an estimated cost.
  </Card>

  <Card title="Pay for previewed results and receive them in full" href="/docs/api-reference/search/searchUnlock">
    Pays for and returns some or all of a preview call's results.
  </Card>

  <Card title="Assisted search (verified results only)" href="/docs/api-reference/search/searchAssisted">
    Agentic retrieval: plans its own searches, verifies every candidate.
  </Card>

  <Card title="List collections" href="/docs/api-reference/search/listCollections">
    Every collection your key can search, at no cost.
  </Card>

  <Card title="Re-fetch cached results" href="/docs/api-reference/search/getCachedResult">
    Retrieve a prior search's results again for free within 7 days.
  </Card>

  <Card title="Current quota usage and limits" href="/docs/api-reference/search/getQuota">
    Daily and monthly query usage against your organization's limits.
  </Card>
</Cards>