> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.overtenai.com/llms.txt > Use this file to discover all available pages before exploring further. # Find potential buyers > Submit a business description and buyer-finding instructions to the sales agent. The run executes in the background. Returns 202 while queued or running, or 200 if it reaches a terminal status within wait_seconds (0–25). Inspect status and stop_reason even on HTTP 200. Poll GET /sales/runs/{run_id} for the answer and collected public evidence. Reusing an idempotency_key within the same organization returns the original run, including its original prompt. ## OpenAPI ````yaml /openapi.json post /sales/runs openapi: 3.1.0 info: title: Overten API version: 1.0.0 description: >- Generate and edit Word, Excel, and PowerPoint documents programmatically. Powered by the same agents as the Overten web app. contact: name: Overten Support url: https://overten.ai/support email: support@overten.ai license: name: Terms of Service url: https://overten.ai/terms servers: - url: https://backend.overtenai.com/api/v1 description: Production - url: http://localhost:8000/api/v1 description: Local development security: - ApiKeyAuth: [] paths: /sales/runs: post: tags: - public - sales summary: Find potential buyers description: >- Submit a business description and buyer-finding instructions to the sales agent. The run executes in the background. Returns 202 while queued or running, or 200 if it reaches a terminal status within wait_seconds (0–25). Inspect status and stop_reason even on HTTP 200. Poll GET /sales/runs/{run_id} for the answer and collected public evidence. Reusing an idempotency_key within the same organization returns the original run, including its original prompt. operationId: start_run_api_v1_sales_runs_post requestBody: content: application/json: schema: $ref: '#/components/schemas/StartSalesRun' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SalesRunResponse' '202': description: Accepted; poll the returned run_id. content: application/json: schema: $ref: '#/components/schemas/SalesRunResponse' '402': description: Insufficient organization API credits; detail includes run_id. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - ApiKeyAuth: [] components: schemas: StartSalesRun: properties: prompt: type: string maxLength: 10000 minLength: 1 title: Prompt description: >- What you sell and who you want to find, as you would tell the sales agent in chat. idempotency_key: anyOf: - type: string maxLength: 200 minLength: 1 - type: 'null' title: Idempotency Key description: >- Reuse this key within your organization to retrieve the original run, even if the prompt changes. Use a new key for each fresh search. Omit it to create a new run on every POST. wait_seconds: type: number maximum: 25 minimum: 0 title: Wait Seconds description: >- Wait up to this many seconds for the background run to finish. A 202 response does not cancel the run; poll GET /sales/runs/{run_id}. default: 0 additionalProperties: false type: object required: - prompt title: StartSalesRun SalesRunResponse: properties: run_id: type: string title: Run Id status: type: string title: Status description: queued, running, completed, paused_budget, failed, or cancelled. stop_reason: anyOf: - type: string - type: 'null' title: Stop Reason description: >- Reason execution stopped, when available. A completed run can still have bounded or incomplete coverage. prompt: type: string title: Prompt search_mode: anyOf: - type: string - type: 'null' title: Search Mode description: >- Search mode this run used: economy (default) or quality. Set per organization; null until the run starts. answer: anyOf: - type: string - type: 'null' title: Answer description: >- The agent's written findings and buyer qualification; null until available. created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At evidence: items: $ref: '#/components/schemas/SalesEvidence' type: array title: Evidence description: >- Collected public source material, including items the agent may reject as leads. Read answer for its judgment; an empty list does not prove there are no buyers. type: object required: - run_id - status - prompt - created_at - updated_at title: SalesRunResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SalesEvidence: properties: platform: type: string title: Platform kind: type: string title: Kind url: anyOf: - type: string - type: 'null' title: Url description: Link to the source post or comment, when supplied by the source. parent_url: anyOf: - type: string - type: 'null' title: Parent Url description: Link to the containing post or video, when available. author: anyOf: - type: string - type: 'null' title: Author published_at: anyOf: - type: string format: date-time - type: 'null' title: Published At text: type: string title: Text seen_before: type: boolean title: Seen Before description: >- An earlier sales run for this organization collected the same evidence. type: object required: - platform - kind - url - parent_url - author - published_at - text - seen_before title: SalesEvidence ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Send `X-API-Key: sk_live_`. Keys are issued via POST /signup or via the dashboard. Legacy callers may also use `Authorization: Bearer sk_live_`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.