# Apiosk

> Ask a question, review the price, and get sourced data through the App, API, or MCP server.

- [Apiosk](https://docs.apiosk.com/index.md): Ask a question, review the price, and get sourced data.
- [Quickstart](https://docs.apiosk.com/overview/quickstart.md): Create a team key, inspect a source, and make a bounded call.
- [Prices and balance](https://docs.apiosk.com/overview/payment-model.md): What buyers see, approve, and are charged.
- [Terminology](https://docs.apiosk.com/overview/terminology.md): The terms used by the App, buyer API, and hosted MCP server.
- [FAQ](https://docs.apiosk.com/overview/faq.md): Answers for teams integrating the App, buyer API, or MCP server.
- [Changelog](https://docs.apiosk.com/overview/changelog.md): Changes to the buyer-facing App, API, and MCP contract.
- [Authentication](https://docs.apiosk.com/api/authentication.md): Organisation API keys: how to create one, what it may do, and what it spends.
- [Sources](https://docs.apiosk.com/api/sources.md): Browse the directory and inspect currently executable operations.
- [Call a source](https://docs.apiosk.com/api/execute.md): Buy one call from one source: the path names what to run, the body carries the inputs.
- [Ask](https://docs.apiosk.com/api/ask.md): Get the same API choices as the Ask page, then execute the selected API with your inputs.
- [European company and tender dossiers](https://docs.apiosk.com/api/workflows.md): Fixed source plans for identity, screening, filings and tender counterparties, with explicit country coverage.
- [Continue a run](https://docs.apiosk.com/api/continue.md): Choose a company or supply missing input on the same saved task, without buying its search again.
- [Runs](https://docs.apiosk.com/api/runs.md): Read a run: its status, its results, what it cost and what is left.
- [Sales signals](https://docs.apiosk.com/api/sales-signals.md): Find current tenders, funding leads, news and company records.
- [Balance and usage](https://docs.apiosk.com/api/billing.md): What a call costs, when money moves, and how to read a key's spending.
- [Idempotency](https://docs.apiosk.com/api/idempotency.md): Retry a paid call safely: the same key pays once.
- [Errors](https://docs.apiosk.com/api/errors.md): One error shape, one code per reason, and whether money moved.
- [Limits](https://docs.apiosk.com/api/limits.md): What bounds a key: money, rate and lifetime.
- [List sources](https://docs.apiosk.com/api-reference/list-sources.md): Free directory of verified sources, including discovery-only and restricted entries. Requires sources:read.
- [Read one source](https://docs.apiosk.com/api-reference/read-one-source.md): Free. Currently executable operations, schemas and buyer prices. Discovery-only sources can return source_not_found. Requires sources:read.
- [Call a source](https://docs.apiosk.com/api-reference/call-a-source.md): Buy one call. The body is the operation's inputs. Requires sources:execute. Also available at /v2/execute/{source}/{operation}.
- [Call a source (explicit form)](https://docs.apiosk.com/api-reference/call-a-source-explicit-form.md): The same call with a named envelope. Requires sources:execute.
- [Plan a question across sources](https://docs.apiosk.com/api-reference/plan-a-question-across-sources.md): Plan across sources. Free in plan mode. Requires ask:create, and ask:execute for auto mode.
- [Discover the same API choices as the Ask page](https://docs.apiosk.com/api-reference/discover-the-same-api-choices-as-the-ask-page.md): Requires ask:create. A question uses the shared App interpreter/search and creates no task, approval or paid provider request. Explicit workflow objects retain their plan/auto behavior.
- [Run a plan](https://docs.apiosk.com/api-reference/run-a-plan.md): Approve the plan against this key's limits and run it. Running twice is the same run. Requires ask:execute.
- [Continue a saved run](https://docs.apiosk.com/api-reference/continue-a-saved-run.md): Requires ask:execute and the same key that created the task. Submit a returned select_entity or supply_input action with its signed state. Resumes existing approved work without buying the search twice. Never approves a new quote. Idempotency-Key is required; retry the same state, action and input u…
- [Read a run](https://docs.apiosk.com/api-reference/read-a-run.md): Free. Also available at GET /v2/asks/{id}.
- [Balance and key limits](https://docs.apiosk.com/api-reference/balance-and-key-limits.md): Free. Requires billing:read.
- [Usage for this key](https://docs.apiosk.com/api-reference/usage-for-this-key.md): Free. This month's spending and recent charges. Requires billing:read.
- [Call a source (v2 alias)](https://docs.apiosk.com/api-reference/call-a-source-v2-alias.md): Buy one call. The body is the operation's inputs. Requires sources:execute. Also available at /v2/execute/{source}/{operation}.
- [Read an ask](https://docs.apiosk.com/api-reference/read-an-ask.md): Free. Also available at GET /v2/asks/{id}.
- [Public source readiness](https://docs.apiosk.com/api-reference/public-source-readiness.md): Aggregate contract and recorded execution coverage, not an exhaustive live source test.
- [Gateway health](https://docs.apiosk.com/api-reference/gateway-health.md): Public protocol and executor readiness; does not prove a paid source call.
- [Browse source endpoints](https://docs.apiosk.com/api-reference/browse-source-endpoints.md): Compact, paginated endpoint index across one source or the Pulse Network group. A listed endpoint can be discovery-only; endpoint.planner_available marks runtime-accepted contracts. Requires sources:read.
- [Find fitting European source operations](https://docs.apiosk.com/api-reference/find-fitting-european-source-operations.md): Free endpoint routing for a structured European capability. Requires sources:read; no provider call or charge.
- [Price a structured European capability](https://docs.apiosk.com/api-reference/price-a-structured-european-capability.md): Save one total-price plan from fitting operations. Requires ask:create. Execution requires a separate POST /v2/asks/{id}/run with ask:execute.
- [Execute the API selected from Ask](https://docs.apiosk.com/api-reference/execute-the-api-selected-from-ask.md): Requires sources:execute. Uses the same selected preparation, authorization and balance executor as the App. Reusing the idempotency key with the same selection/input recovers the saved run. The existing signed App/MCP continuation body remains supported separately.
- [List fixed workflows and country coverage](https://docs.apiosk.com/api-reference/ask/list-fixed-workflows-and-country-coverage.md): Free. Requires sources:read. Uses the same recipes as the App. Availability reflects planning, not paid result validation.
- [MCP server](https://docs.apiosk.com/mcp/overview.md): Connect an assistant, review one price, and receive saved source results.
- [MCP clients](https://docs.apiosk.com/guides/mcp-clients.md): Connect the hosted Apiosk MCP server to an assistant.
- [Organisations and workspaces](https://docs.apiosk.com/app/organisations.md): Who can spend what: members, workspaces, budgets and the main balance.
- [API keys](https://docs.apiosk.com/app/api-keys.md): Create, limit and revoke the keys your servers use.
- [Connections](https://docs.apiosk.com/app/connections.md): How an assistant comes to hold a credential that can spend, and what bounds it.

## OpenAPI Specs

- [apiosk-api](/openapi/apiosk-api.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.