Company APIs

Company Enrichment

Submit one or more identifiers for a company - domain, email, phone, or a company social_media_url - and receive a firmographic profile with fields such as industry, headcount, locations, funding, web presence, domains, emails, and phone numbers when available. Fields with no data are omitted from the response. The request is queued asynchronously and returns a request_id; poll the status endpoint or supply a callback_url. At least one identifier is required. Credits are charged only when the enrichment returns data.

POST https://api.nyne.ai/company/enrichment API key

API Key API Secret

Manual credentials take precedence over your account key.

Overview

Resolve a full company profile from a domain, email, phone, or LinkedIn URL.

Parameters

domain string optional

Company website domain. Scheme, www., and path are stripped automatically before matching.

email string optional

Company email address. Validated for format.

phone string optional

Company phone number (digits, spaces, dashes, parentheses, and + only).

social_media_url string optional

LinkedIn company profile URL.

callback_url string optional

http(s) URL on an allowed host that receives the completed enrichment payload.

Polling for the result

This endpoint is asynchronous. A successful submit returns a request_id while the job runs in the background. Poll the same path with a GET request - same authentication headers - passing the request_id as a query parameter:

Loading your API credentials...

Each poll returns the job's current status; once it is completed the payload carries the result shown under Responses. Polling an unknown or expired request_id returns 404 request_not_found.

Status	Meaning
queued · processing · pending	The job is still running - keep polling.
completed	The job finished; the payload carries the result and completed: true.
failed	Terminal - the job could not complete; the error field explains why.

Poll every few seconds at first, backing off for long-running jobs. Polling is free - status checks never burn credits.

Prefer push delivery?

Supply the optional callback_url parameter and the completed payload is POSTed to your endpoint when the job finishes - no polling required. Delivery is retried up to 5 times with exponential backoff (1s, 5s, 15s, 1m, 5m) and a 30-second timeout per attempt; respond with a 2xx status to acknowledge receipt.

Credit usage

Credits are charged based on the matched configuration. The listed cost is the per-result unit price.

Feature	Credits	Notes
Company Enrichment	-	Charged once per request, only on a meaningful result
No match	0	No data found never burns credits

Heads up

A positive credit balance is required before each request. Empty results do not burn credits.

Responses

202 Enrichment queued - poll the status endpoint with the returned request_id

400 missing_parameters / invalid_email / invalid_phone / invalid_url / invalid_domain / invalid_callback_url

401 Missing or invalid API credentials

402 insufficient_credits

403 subscription_required or ip_not_allowed

404 not_found - no company matched the supplied identifiers (no credits charged)

429 rate_limit_exceeded / monthly_limit_exceeded

503 service_unavailable - the API is temporarily unavailable

A successful response wraps the payload in the { success, data, timestamp } envelope (also shown live in the panel on the right):

{
  "success": true,
  "data": {
    "request_id": "dfd84d2d1f065a9b4e7fbc3df6aabbb6_1700000123_8123",
    "status": "completed",
    "completed": true,
    "result": {
      "company_name": "Tesla, Inc.",
      "website": "https://www.tesla.com",
      "description": "Designs and manufactures electric vehicles and energy storage systems.",
      "linkedin_url": "https://www.linkedin.com/company/tesla-motors/",
      "industry": "Automotive",
      "specialties": [
        "Electric Vehicles",
        "Energy Storage"
      ],
      "headcount_range": "10,001+",
      "locations": [
        {
          "city": "Austin",
          "state": "Texas",
          "country": "United States"
        },
        {
          "city": "Fremont",
          "state": "California",
          "country": "United States"
        }
      ],
      "funding": {
        "last_round": "Post-IPO",
        "funding_total": "20.2B"
      },
      "sic_codes": [
        "3711"
      ],
      "naics_codes": [
        "336111"
      ],
      "emails": [
        "[email protected]"
      ],
      "phone_numbers": [
        "+1-512-516-8177"
      ]
    },
    "completed_on": "2026-01-15T10:35:00Z"
  },
  "timestamp": "2026-01-01T00:00:00"
}