> ## Documentation Index > Fetch the complete documentation index at: https://docs.leadpipe.com/llms.txt > Use this file to discover all available pages before exploring further. # Look up a company by IP address > Look up stored company information for an IPv4 or IPv6 address. Each company result uses one lookup unit; a null result uses none. See [Lookup usage and limits](/ip-to-company/introduction) for authentication, allowances, and error handling. ## OpenAPI ````yaml https://api.aws53.cloud/openapi-data.json get /v1/data/company openapi: 3.1.0 info: title: Identification API version: 1.0.0 description: >- Programmatic access to your visitor data and pixel management. Authenticate with your API key (X-API-Key header). servers: - url: https://api.aws53.cloud description: Production security: - apiKeyAuth: [] tags: - name: Visitors description: Visitor resources and privacy-bounded activity. - name: Pixels description: Tracking pixel installation and configuration. - name: Account description: Organization account health and API entitlements. - name: Visitor Suppression description: Organization visitor suppression rules. paths: /v1/data/company: get: tags: - Visitors summary: Look up a company by IP address description: >- Returns stored company information for one IPv4 or IPv6 address. Requires an active X-API-Key and an eligible organization. IPv6 spelling is normalized and IPv4-mapped IPv6 uses its IPv4 equivalent. No visit, pixel, organization or person data is returned. Results are provider-reported stored mappings, not proof of IP ownership, and may be stale. Missing or non-company results return data: null and consume zero units; no new enrichment request is started. Every company-returning request, including repeat requests for the same IP, consumes one unit of a separate organization-wide company-lookup allowance equal to the effective identification-plan limit. Other products do not consume this allowance. All organization API keys share it; it resets when the existing organization billing allowance resets. Once exhausted, further lookups are refused. Requests are limited to 60 per minute per client IP. Responses must not be cached or prefetched because successful lookups consume allowance. Rate-limit headers describe request pacing, while meta describes the company allowance. operationId: lookupCompanyByIp parameters: - schema: type: string maxLength: 64 description: >- One IPv4 or IPv6 address, without a URL, port, CIDR or IPv6 zone identifier. example: 192.0.2.10 required: true description: >- One IPv4 or IPv6 address, without a URL, port, CIDR or IPv6 zone identifier. name: ip in: query example: 192.0.2.10 responses: '200': description: Stored company result and the separate company-lookup allowance. headers: RateLimit-Limit: description: Maximum requests in the current application rate-limit window schema: type: integer RateLimit-Remaining: description: Requests remaining in the current application rate-limit window schema: type: integer RateLimit-Reset: description: Seconds until the current application rate-limit window resets schema: type: integer Cache-Control: description: 'Always no-store: company-returning requests consume allowance.' schema: type: string enum: - no-store content: application/json: schema: type: object properties: data: type: - object - 'null' properties: ip: type: string description: Normalized IP address that was looked up. businessCategory: type: string description: >- Provider audience classification; empty when unavailable. businessSegment: type: string description: Provider audience segment; empty when unavailable. dataCompleteness: type: string description: >- Provider detail classification, not a computed completeness score; empty when unavailable. isInternetProvider: type: - boolean - 'null' description: >- Whether the provider identifies the result as an ISP; null when unknown. name: type: string description: >- Company name; can be empty if only a company identifier was supplied. website: type: string description: Company website or domain; empty when unavailable. tradeName: type: string description: >- Company marketing name, not necessarily a registered trade name; empty when unavailable. industry: type: string description: Company industry; empty when unavailable. subIndustry: type: string description: Company sub-industry; empty when unavailable. linkedinUrl: type: - string - 'null' description: >- Company LinkedIn profile URL, or null when unavailable. employeeCount: type: - integer - 'null' minimum: 0 maximum: 9007199254740991 description: >- Provider-reported employee count, or null when unavailable. annualSales: type: - integer - 'null' minimum: 0 maximum: 9007199254740991 description: >- Provider-reported annual sales amount, or null when unavailable; currency is not supplied by the source. revenueRange: type: string description: Provider revenue range; empty when unavailable. primaryNaics: type: string description: >- Primary NAICS code, retained as text; empty when unavailable. primarySic: type: string description: >- Primary SIC code, retained as text; empty when unavailable. city: type: string description: Company city; empty when unavailable. state: type: string description: Company state or region; empty when unavailable. postalCode: type: string description: Company postal code; empty when unavailable. countryCode: type: string description: Company country code; empty when unavailable. countryName: type: string description: Company country name; empty when unavailable. required: - ip - businessCategory - businessSegment - dataCompleteness - isInternetProvider - name - website - tradeName - industry - subIndustry - linkedinUrl - employeeCount - annualSales - revenueRange - primaryNaics - primarySic - city - state - postalCode - countryCode - countryName description: >- Company details, or null when no successful company identity is stored. A null result does not prove that the IP is not used by a company. meta: type: object properties: credits_consumed: type: integer minimum: 0 maximum: 1 description: >- Company-lookup units consumed by this request: one for a company, otherwise zero. limit: type: integer minimum: 0 description: >- Organization company-lookup allowance for the current billing period. used: type: integer minimum: 0 description: >- Company-lookup units used in this period, including this request. remaining: type: integer minimum: 0 description: Company-lookup units remaining after this request. required: - credits_consumed - limit - used - remaining required: - data - meta examples: company: value: data: ip: 192.0.2.10 businessCategory: Enterprise Business businessSegment: Software & Technology dataCompleteness: Detailed isInternetProvider: false name: Example Software website: example.test tradeName: Example industry: Software subIndustry: '' linkedinUrl: null employeeCount: 100 annualSales: null revenueRange: '' primaryNaics: '' primarySic: '' city: '' state: '' postalCode: '' countryCode: US countryName: United States meta: credits_consumed: 1 limit: 5000 used: 1 remaining: 4999 noCompany: value: data: null meta: credits_consumed: 0 limit: 5000 used: 0 remaining: 5000 '400': description: Invalid IP address. content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: {} required: - code - message meta: type: object properties: timestamp: type: string request_id: type: string required: - timestamp - request_id required: - error example: error: code: HTTP_ERROR message: Expected one IPv4 or IPv6 address '401': description: Missing or invalid API key. content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: {} required: - code - message meta: type: object properties: timestamp: type: string request_id: type: string required: - timestamp - request_id required: - error example: error: code: HTTP_ERROR message: Missing X-API-Key header '403': description: Revoked key or ineligible organization. content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: {} required: - code - message meta: type: object properties: timestamp: type: string request_id: type: string required: - timestamp - request_id required: - error example: error: code: HTTP_ERROR message: Organization is not eligible for company lookups '429': description: >- Request rate limit or company allowance exhausted. Retry-After is supplied for request-rate limits; allowance exhaustion requires a billing reset or a limit increase. headers: RateLimit-Limit: description: Maximum requests in the current application rate-limit window schema: type: integer RateLimit-Remaining: description: Requests remaining in the current application rate-limit window schema: type: integer RateLimit-Reset: description: Seconds until the current application rate-limit window resets schema: type: integer Retry-After: description: Seconds to wait before retrying schema: type: integer content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: {} required: - code - message meta: type: object properties: timestamp: type: string request_id: type: string required: - timestamp - request_id required: - error example: error: code: HTTP_ERROR message: >- Company lookup allowance exhausted for the current billing period '503': description: >- Company lookup or allowance storage unavailable; no company response is delivered. content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: {} required: - code - message meta: type: object properties: timestamp: type: string request_id: type: string required: - timestamp - request_id required: - error example: error: code: HTTP_ERROR message: Company lookup temporarily unavailable security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Organization API key (sk_...). Get yours from Settings > API Keys in the dashboard. ````