# Docs

- [Overview](/docs): What the OngoingAI API returns, where it lives, and how these docs stay true to it.

- **REST API**
- [Quickstart](/docs/quickstart): Create a key, confirm it works, and read your first store profile.
- [Authentication](/docs/authentication): Workspace API keys, scopes, environments, and how to keep keys safe.
- [Connect with a client](/docs/clients): The TypeScript SDK, plain fetch, cURL, and Python, with retries, idempotency, and pacing done right.
- [Errors and limits](/docs/errors): The error envelope, stable codes, request ids, rate limits, and idempotent retries.
- [Billing units and plans](/docs/billing): What consumes a unit, what never does, and the limits each plan enforces.
- Reference
  - [API reference](/docs/reference): Every served operation, generated from the contract on each release.
  - Account
    - [Validate the key and discover capabilities](/docs/reference/account/get-account): Returns the workspace, the key used for this request, the plan limits in force, and the current billing period. Make this the first call of any integration: it tells you which scopes you hold and how much allowance remains before you spend any of it.
    - [Usage this period](/docs/reference/account/get-usage): Consumption by billing unit for the current period, in total and per key. Updated within five minutes of each request.
  - Stores
    - [Enrich up to 100 domains](/docs/reference/stores/enrich-stores): Batch form of the store profile. Each input is canonicalized and answered independently; the response preserves input order. Matched and stale inputs return the full store object. No-match inputs return a reason and are not billed. With `refresh: true` and the `write:scans` scope, unknown or stale domains are queued for observation and the result is marked `scan_requested`.
    - [Store profile by domain](/docs/reference/stores/get-store): The current profile of one store from completed observations: platform, technologies with install state and dates, geography, industry, catalog aggregates, lifecycle status, and the last five confirmed signals. Cacheable; identical inputs return identical bodies until the next completed observation.
  - Technologies
    - [One technology](/docs/reference/technologies/get-technology): Metadata for one slug.
    - [Technology vocabulary](/docs/reference/technologies/list-technologies): The canonical list of platforms, apps, services, and themes the API can report, with categories. Slugs here are the same slugs used in store profiles, signals, webhooks, and MCP tools.
  - Service
    - [Service health](/docs/reference/service/get-health): Liveness and build identity. Unauthenticated and unmetered.
    - [What this host serves](/docs/reference/service/get-index): Discovery document for the host: the REST base url, the GraphQL endpoint, where the OpenAPI document lives, and where to get a key. Unauthenticated, unmetered, and static — it reads nothing and says nothing about system health.
    - [Operations served at v1](/docs/reference/service/get-version-index): The operations this build serves, as operation id to URL. Unauthenticated and unmetered. An operation defined in the contract but not yet implemented is omitted here.

- **GraphQL API**
- [GraphQL](/docs/graphql): The same graph, queried as a graph. Available to first-party surfaces today.

- **Concepts**
- Concepts
  - [Observations and evidence](/docs/concepts/observations): How to read freshness, scope, install states, and absence without drawing conclusions the data does not support.
- [For agents](/docs/agents): Where the machine-readable versions of these docs live, and the rules an agent needs before calling the API on someone's behalf.