> ## Documentation Index > Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Enrich a company > Enrich a company with normalized firmographic fields (industry, headcount, HQ, founded year, technologies, funding, …). REQUIRES a `identifiers` object containing one or more of: `domain`, `name` (or `company_name`), `linkedin_url` (or `company_linkedin_url`). `domain` is the strongest signal — prefer it when available. Optional `fields[]` narrows the waterfall. Field-aware waterfall same as `/people/enrich`. ## OpenAPI ````yaml /openapi/agnt.openapi.json post /v1/data/agnt/companies/enrich openapi: 3.0.0 info: title: agntdata Lead APIs description: >- Internal lead enrichment API surface that orchestrates multiple upstream data providers behind a single endpoint per use case. Use these endpoints to find and verify professional emails, find mobile phone numbers, enrich and search people and companies, discover companies, list a domain's email addresses, run bulk people/company enrichments, and fetch company intelligence (funding/competitors/technographics). Provider names are never returned — agntdata picks the cheapest providers that can fulfill the requested fields and merges results. version: 1.0.0 contact: name: agntdata url: https://agntdata.dev servers: - url: https://api.agntdata.dev description: agntdata API security: - ApiKeyAuth: [] tags: - name: People — Email description: Find, verify, and enrich professional email addresses. - name: People — Enrich description: Enrich people with structured profile data. - name: People — Mobile description: Find mobile phone numbers from a profile. - name: People — Search description: Search the people graph by structured filters. - name: Companies — Discover description: Discover companies that match a set of criteria. - name: Companies — Email description: List the email addresses found for a company domain. - name: Companies — Enrich description: Enrich companies with firmographic data. - name: Companies — Search description: Search the company graph by structured filters. - name: Companies — Intelligence description: Funding, competitors, and technographics for a company. paths: /v1/data/agnt/companies/enrich: post: tags: - Companies — Enrich summary: Enrich a company description: >- Enrich a company with normalized firmographic fields (industry, headcount, HQ, founded year, technologies, funding, …). REQUIRES a `identifiers` object containing one or more of: `domain`, `name` (or `company_name`), `linkedin_url` (or `company_linkedin_url`). `domain` is the strongest signal — prefer it when available. Optional `fields[]` narrows the waterfall. Field-aware waterfall same as `/people/enrich`. operationId: companies_enrich requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CompaniesEnrichRequest' example: identifiers: domain: stripe.com responses: '200': description: Company enrichment result. content: application/json: schema: $ref: '#/components/schemas/Post_agnt_companies_enrich_Response' '400': description: Validation error. '402': description: Insufficient credits. security: - ApiKeyAuth: [] components: schemas: CompaniesEnrichRequest: type: object properties: identifiers: type: object properties: domain: type: string minLength: 1 description: >- Company root domain (e.g. "tesla.com"). Strongest signal — prefer when available. name: type: string minLength: 1 description: Company name (e.g. "Tesla"). Use when domain is unknown. company_name: type: string minLength: 1 description: Alias of `name`. linkedin_url: type: string format: uri description: >- Full company LinkedIn URL (e.g. https://www.linkedin.com/company/tesla-motors). company_linkedin_url: type: string format: uri description: Alias of `linkedin_url`. additionalProperties: false description: >- Unique handles to resolve the company. Provide AT LEAST ONE of `domain`, `name`/`company_name`, or `linkedin_url`/`company_linkedin_url`. fields: type: array items: type: string enum: - name - domain - description - industry - employee_count_range - employee_count - hq_location - founded_year - linkedin_url - twitter_url - technologies - funding - competitors max_cost_cents: type: number minimum: 0 required: - identifiers additionalProperties: false Post_agnt_companies_enrich_Response: type: object required: - success - data properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/CompaniesEnrichResponse' meta: $ref: '#/components/schemas/AgntMeta' CompaniesEnrichResponse: type: object properties: name: type: string nullable: true domain: type: string nullable: true description: type: string nullable: true industry: type: string nullable: true employee_count: type: number nullable: true employee_count_range: type: string nullable: true hq_location: type: string nullable: true founded_year: anyOf: - type: number - type: string nullable: true linkedin_url: type: string nullable: true twitter_url: type: string nullable: true technologies: {} funding: {} competitors: {} additionalProperties: false AgntMeta: type: object properties: costCents: type: number purchasedBalanceCents: type: number subscriptionRemainingCents: type: number cached: type: boolean latencyMs: type: number priceRange: type: object properties: minCents: type: number maxCents: type: number required: - minCents - maxCents additionalProperties: false budgetCents: type: number budgetCentsPerRecord: type: number providersAttempted: type: number fieldsReturned: type: array items: type: string fieldsMissing: type: array items: type: string records: type: number required: - costCents - purchasedBalanceCents - subscriptionRemainingCents - cached - latencyMs additionalProperties: true securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: >- Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_... ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.