> ## 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 # Combined Enrichment > Usage-based billing; Default request estimate: $0.0043 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/hunter/combined-enrichment * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/hunter/combined-enrichment` * **Runtime facts:** 9d6cd55f4883e0d802c7a28091c00738a9992688a6c242f0fae404a62c5146a1 [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/hunter.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "hunter.combined-enrichment", "method": "POST", "path": "/apis/v1/hunter/combined-enrichment", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "examples": [ "matt@hunter.io" ], "description": "The professional's email address to enrich. Either email or linkedin must be provided." }, "linkedin": { "type": "string", "examples": [ "mattbasta" ], "description": "LinkedIn handle as alternative to email. Either email or linkedin must be provided." } } } } } }, "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.0043, "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.0043 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.0043 * **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/hunter.json POST /apis/v1/hunter/combined-enrichment openapi: 3.1.0 info: description: '' title: Hunter 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/hunter/combined-enrichment - /apis/v1/hunter/combined-find - /apis/v1/hunter/companies-emails - /apis/v1/hunter/companies-enrich - /apis/v1/hunter/company-enrichment - /apis/v1/hunter/domain-search - /apis/v1/hunter/email-finder - /apis/v1/hunter/multi-domain-search-reveal - /apis/v1/hunter/people-email-find - /apis/v1/hunter/people-enrich - /apis/v1/hunter/people-enrichment x-aisa-document: facts_hash: 9d6cd55f4883e0d802c7a28091c00738a9992688a6c242f0fae404a62c5146a1 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: - operation_id: hunter.combined-find path: /apis/v1/hunter/combined-find method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: hunter.companies-emails path: /apis/v1/hunter/companies-emails method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: hunter.companies-enrich path: /apis/v1/hunter/companies-enrich method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: hunter.people-email-find path: /apis/v1/hunter/people-email-find method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: hunter.people-enrich path: /apis/v1/hunter/people-enrich method: GET statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:222fdc2d20e3aa2988cfe6d40b000dd334548495bdd66474d0e7fc92b8a291bb x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: hunter x-aisa-catalogs: hunter: title: Hunter description: '' x-aisa-document: facts_hash: 9d6cd55f4883e0d802c7a28091c00738a9992688a6c242f0fae404a62c5146a1 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/hunter/combined-enrichment: post: tags: - Hunter summary: Combined Enrichment description: >- Usage-based billing; Default request estimate: $0.0043 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. operationId: hunter.combined-enrichment requestBody: required: false content: application/json: schema: type: object properties: email: type: string examples: - matt@hunter.io description: >- The professional's email address to enrich. Either email or linkedin must be provided. linkedin: type: string examples: - mattbasta description: >- LinkedIn handle as alternative to email. Either email or linkedin must be provided. responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__914e518ef4d9c132 Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__914e518ef4d9c132: type: object required: - data - meta properties: data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__3585e4def1255f9c meta: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__dabbd834ccebdd8e Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__3585e4def1255f9c: type: object required: - person - company properties: person: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__801a7bed5bd96761 - type: 'null' company: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__4cb9a150c492c7ed - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__dabbd834ccebdd8e: type: object required: - email properties: email: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__801a7bed5bd96761: type: object required: - id - name - email - location - geo - bio - site - avatar - employment - facebook - github - twitter - linkedin - googleplus - gravatar - fuzzy - phone properties: id: anyOf: - type: string - type: 'null' bio: anyOf: - type: string - type: 'null' geo: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__09f94a58a66bf19c - type: 'null' name: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__fdfc5f66792dc3e9 - type: 'null' site: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' fuzzy: anyOf: - type: boolean - type: 'null' phone: anyOf: - type: string - type: 'null' avatar: anyOf: - type: string - type: 'null' github: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__2d49e87fdc182494 - type: 'null' twitter: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__2d49e87fdc182494 - type: 'null' activeAt: type: string facebook: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__2d49e87fdc182494 - type: 'null' gravatar: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__420b5d6505e66690 - type: 'null' linkedin: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__2d49e87fdc182494 - type: 'null' location: anyOf: - type: string - type: 'null' timeZone: type: string indexedAt: type: string utcOffset: type: integer employment: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__1f79c5bd4a4f46c8 - type: 'null' googleplus: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__2d49e87fdc182494 - type: 'null' inactiveAt: type: string emailProvider: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__4cb9a150c492c7ed: type: object required: - id - name - domain - site - category - description - location - geo - logo - facebook - linkedin - twitter - crunchbase - instagram - type - ticker - identifiers - phone - metrics - parent properties: id: anyOf: - type: string - type: 'null' geo: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__3928a4991ca1a38b - type: 'null' logo: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' site: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__6b24be589605b796 - type: 'null' tags: type: array items: type: string tech: type: array items: type: string type: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' domain: anyOf: - type: string - type: 'null' parent: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__a41b7ce8e55c9bdc - type: 'null' ticker: anyOf: - type: string - type: 'null' metrics: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__f30305383b7b7877 - type: 'null' twitter: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__9fd24d3f1e50a376 - type: 'null' category: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__5d856b1e9e1c89be - type: 'null' facebook: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__34d1b907a7ac6cba - type: 'null' linkedin: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__5835e88231596675 - type: 'null' location: anyOf: - type: string - type: 'null' timeZone: type: string instagram: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__f794377c4c2ad7c6 - type: 'null' legalName: type: string utcOffset: type: integer crunchbase: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__afac08dd722ec186 - type: 'null' companyType: type: string description: anyOf: - type: string - type: 'null' foundedYear: type: integer identifiers: anyOf: - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__fb53b9d8a32a5e9d - type: 'null' domainAliases: type: array items: type: string emailProvider: type: string fundingRounds: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__f74d075fa7097761 techCategories: type: array items: type: string ultimateParent: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__32c7e501010edf82 Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__09f94a58a66bf19c: type: object required: - city - state - country - lat - lng properties: lat: anyOf: - type: number - type: 'null' lng: anyOf: - type: number - type: 'null' city: anyOf: - type: string - type: 'null' state: anyOf: - type: string - type: 'null' country: anyOf: - type: string - type: 'null' stateCode: type: string countryCode: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__fdfc5f66792dc3e9: type: object properties: fullName: type: string givenName: type: string familyName: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__2d49e87fdc182494: type: object required: - handle properties: handle: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__420b5d6505e66690: type: object required: - handle - avatar properties: urls: type: array items: type: string avatar: anyOf: - type: string - type: 'null' handle: anyOf: - type: string - type: 'null' avatars: type: array items: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__1f79c5bd4a4f46c8: type: object required: - domain - name - title - role - seniority properties: name: anyOf: - type: string - type: 'null' role: anyOf: - type: string - type: 'null' title: anyOf: - type: string - type: 'null' domain: anyOf: - type: string - type: 'null' subRole: type: string seniority: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__3928a4991ca1a38b: type: object required: - city - state - country - lat - lng properties: lat: anyOf: - type: number - type: 'null' lng: anyOf: - type: number - type: 'null' city: anyOf: - type: string - type: 'null' state: anyOf: - type: string - type: 'null' country: anyOf: - type: string - type: 'null' stateCode: type: string postalCode: type: string streetName: type: string subPremise: type: string countryCode: type: string streetNumber: type: string streetAddress: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__6b24be589605b796: type: object properties: phoneNumbers: type: array items: type: string emailAddresses: type: array items: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__a41b7ce8e55c9bdc: type: object required: - domain properties: domain: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__f30305383b7b7877: type: object required: - employees - raised properties: raised: anyOf: - type: string - type: 'null' employees: anyOf: - type: string - type: 'null' marketCap: type: string trafficRank: type: string annualRevenue: type: string fiscalYearEnd: type: string estimatedAnnualRevenue: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__9fd24d3f1e50a376: type: object required: - handle - id - bio - followers - following - location - site - avatar properties: id: anyOf: - type: integer - type: 'null' bio: anyOf: - type: string - type: 'null' site: anyOf: - type: string - type: 'null' avatar: anyOf: - type: string - type: 'null' handle: anyOf: - type: string - type: 'null' location: anyOf: - type: string - type: 'null' followers: anyOf: - type: integer - type: 'null' following: anyOf: - type: integer - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__5d856b1e9e1c89be: type: object required: - sector - industry properties: sector: anyOf: - type: string - type: 'null' sicCode: type: string industry: anyOf: - type: string - type: 'null' naicsCode: type: string subIndustry: type: string industryGroup: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__34d1b907a7ac6cba: type: object required: - handle properties: handle: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__5835e88231596675: type: object required: - handle properties: handle: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__f794377c4c2ad7c6: type: object required: - handle properties: handle: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__afac08dd722ec186: type: object required: - handle properties: handle: anyOf: - type: string - type: 'null' Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__fb53b9d8a32a5e9d: type: object properties: usEIN: type: string Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__f74d075fa7097761: type: object properties: {} Response576A0Ea506F3_connect_HUNTER_COMBINED_ENRICHMENT__output__32c7e501010edf82: type: object required: - domain properties: domain: anyOf: - type: string - type: 'null' securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.