> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Enrich Person > Usage-based billing; Default request estimate: $0.0243 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/prospeo/enrich-person * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/prospeo/enrich-person` * **Runtime facts:** 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/prospeo.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "prospeo.enrich-person", "method": "POST", "path": "/apis/v1/prospeo/enrich-person", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "person": { "type": "object", "examples": [ { "linkedin_url": "https://www.linkedin.com/in/eoghanmccabe" } ], "properties": { "email": { "type": "string", "description": "Known email address for the person. This is sufficient by itself." }, "full_name": { "type": "string", "description": "Person's full name. Use with a company identifier." }, "last_name": { "type": "string", "description": "Person's last name. Use with first_name and a company identifier." }, "person_id": { "type": "string", "description": "Prospeo person ID. This is sufficient by itself." }, "first_name": { "type": "string", "description": "Person's first name. Use with last_name and a company identifier." }, "company_name": { "type": "string", "description": "Current company name. Website or LinkedIn URL is usually a stronger match." }, "linkedin_url": { "type": "string", "description": "Person's LinkedIn profile URL. This is sufficient by itself." }, "company_website": { "type": "string", "description": "Current company's root website or domain." }, "company_linkedin_url": { "type": "string", "description": "Current company's LinkedIn URL." } }, "description": "Person matching datapoints. More datapoints generally improve matching.", "additionalProperties": false, "required": [ "email" ] }, "enrich_mobile": { "enum": [ false ], "type": "boolean", "description": "Request mobile enrichment. WARNING: a found mobile costs 10 credits and also includes email enrichment." }, "only_verified_email": { "type": "boolean", "default": false, "description": "Return a record only when it has an email Prospeo marks verified." }, "only_verified_mobile": { "enum": [ false ], "type": "boolean", "description": "Return a record only when it has a verified mobile. Setting true enables enrich_mobile; a found mobile may therefore cost 10 credits." } }, "required": [ "enrich_mobile", "only_verified_mobile", "person" ] } } } }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0243, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Usage-based billing; Default request estimate: \$0.0243 USD (not a fixed price). Declared unit rate: \$0.000001 USD per provider\_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.0243 * **Declared unit rate (USD):** 1e-06 * **Billing unit:** provider\_credit * **Cost contract:** response\_units * **Published reference multiplier:** 1.0 * **Declared maximum count/units:** 10000000 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml reference-contracts/prospeo.json POST /apis/v1/prospeo/enrich-person openapi: 3.1.0 info: description: '' title: Prospeo version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/prospeo/bulk-enrich-people - /apis/v1/prospeo/companies-enrich - /apis/v1/prospeo/companies-search - /apis/v1/prospeo/enrich-company - /apis/v1/prospeo/enrich-person - /apis/v1/prospeo/people-email-find - /apis/v1/prospeo/people-enrich - /apis/v1/prospeo/people-phone-find - /apis/v1/prospeo/people-search - /apis/v1/prospeo/search-companies - /apis/v1/prospeo/search-people x-aisa-document: facts_hash: 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: [] document_hash: sha256:800c53f325e017eb334f7f939c4188d558bb0146a82770dbae46c0b909468190 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: prospeo x-aisa-catalogs: prospeo: title: Prospeo description: '' x-aisa-document: facts_hash: 14747b6d3b7c1fb8f4ed610011f8f5654aa07f8d884665f33860fa90664909fa generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/prospeo/enrich-person: post: tags: - Prospeo summary: Enrich Person description: >- Usage-based billing; Default request estimate: $0.0243 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. operationId: prospeo.enrich-person requestBody: required: true content: application/json: schema: type: object properties: person: type: object examples: - linkedin_url: https://www.linkedin.com/in/eoghanmccabe properties: email: type: string description: >- Known email address for the person. This is sufficient by itself. full_name: type: string description: Person's full name. Use with a company identifier. last_name: type: string description: >- Person's last name. Use with first_name and a company identifier. person_id: type: string description: Prospeo person ID. This is sufficient by itself. first_name: type: string description: >- Person's first name. Use with last_name and a company identifier. company_name: type: string description: >- Current company name. Website or LinkedIn URL is usually a stronger match. linkedin_url: type: string description: >- Person's LinkedIn profile URL. This is sufficient by itself. company_website: type: string description: Current company's root website or domain. company_linkedin_url: type: string description: Current company's LinkedIn URL. description: >- Person matching datapoints. More datapoints generally improve matching. additionalProperties: false required: - email enrich_mobile: enum: - false type: boolean description: >- Request mobile enrichment. WARNING: a found mobile costs 10 credits and also includes email enrichment. only_verified_email: type: boolean default: false description: >- Return a record only when it has an email Prospeo marks verified. only_verified_mobile: enum: - false type: boolean description: >- Return a record only when it has a verified mobile. Setting true enables enrich_mobile; a found mobile may therefore cost 10 credits. required: - enrich_mobile - only_verified_mobile - person responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__7ee62159510b9b1d Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__7ee62159510b9b1d: type: object required: - free_enrichment - person properties: person: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__ad7687d1958bb08d - type: 'null' company: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__61793974067aa99d free_enrichment: type: boolean Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__ad7687d1958bb08d: type: object properties: email: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__46e12dbaa37f3fd7 mobile: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__1b5dc22ab65f9e8e skills: type: array items: type: string headline: type: string location: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__39a2e13d856811ec full_name: type: string last_name: type: string person_id: type: string first_name: type: string job_history: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__facb8b909af08b1c linkedin_url: type: string current_job_key: type: string current_job_title: type: string linkedin_member_id: type: string last_job_change_detected_at: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__61793974067aa99d: type: object properties: name: type: string type: type: string domain: type: string founded: type: integer funding: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__41e0a0f43c268af5 website: type: string industry: type: string keywords: type: array items: type: string location: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__20b6b1d8f0c1ac14 logo_url: type: string phone_hq: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__234a830bb70692ce sic_codes: type: array items: type: string attributes: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__f000885c57a8bd14 company_id: type: string email_tech: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__d2690f4547d1eb4b technology: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__9989b36731b61972 description: type: string linkedin_id: type: string naics_codes: type: array items: type: string twitter_url: type: string youtube_url: type: string facebook_url: type: string job_postings: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__29f3030b5cbe0625 linkedin_url: type: string instagram_url: type: string revenue_range: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__1b2fe457a98d9bc8 crunchbase_url: type: string description_ai: type: string employee_count: type: integer employee_range: type: string other_websites: type: array items: type: string description_seo: type: string revenue_range_printed: type: string employee_count_on_prospeo: type: integer Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__46e12dbaa37f3fd7: type: object properties: email: type: string status: type: string revealed: type: boolean email_mx_provider: type: string verification_method: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__1b5dc22ab65f9e8e: type: object properties: mobile: type: string status: type: string revealed: type: boolean mobile_country: type: string mobile_national: type: string mobile_country_code: type: string mobile_international: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__39a2e13d856811ec: type: object properties: city: type: string state: type: string country: type: string time_zone: type: string country_code: type: string time_zone_offset: type: number Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__facb8b909af08b1c: type: object properties: title: type: string current: type: boolean job_key: type: string end_year: type: integer logo_url: type: string end_month: type: integer seniority: type: string company_id: type: string start_year: type: integer departments: type: array items: type: string start_month: type: integer company_name: type: string duration_in_months: type: integer Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__41e0a0f43c268af5: type: object properties: count: type: integer total_funding: type: number funding_events: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__9ede638bbb5ca149 latest_funding_date: type: string latest_funding_stage: type: string total_funding_printed: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__20b6b1d8f0c1ac14: type: object properties: city: type: string state: type: string country: type: string raw_address: type: string country_code: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__234a830bb70692ce: type: object properties: phone_hq: type: string phone_hq_country: type: string phone_hq_national: type: string phone_hq_country_code: type: string phone_hq_international: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__f000885c57a8bd14: type: object properties: is_b2b: type: boolean has_demo: type: boolean has_pricing: type: boolean has_free_trial: type: boolean has_mobile_apps: type: boolean has_downloadable: type: boolean has_online_reviews: type: boolean Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__d2690f4547d1eb4b: type: object properties: domain: type: string mx_provider: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__9989b36731b61972: type: object properties: count: type: integer technology_list: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__5894a3348346eadb technology_names: type: array items: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__29f3030b5cbe0625: type: object properties: active_count: type: integer active_titles: type: array items: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__1b2fe457a98d9bc8: type: object properties: max: type: number min: type: number Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__9ede638bbb5ca149: type: object properties: link: type: string stage: type: string amount: type: number raised_at: type: string amount_printed: type: string Response576A0Ea506F3_connect_PROSPEO_ENRICH_PERSON__output__5894a3348346eadb: type: object properties: name: type: string category: type: string securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.