Elvesora Enrichment API Docs

First request

Use a business domain for the v1 API endpoint. Send an Idempotency-Key header when retrying a request that should replay the cached result without another credit during the 24-hour cache window.

To verify a team API bearer token first, send GET /api/v1/account with the same Authorization header. An active credential returns data.credential_status: active, data.product: company_enrichment, and data.api_version: v1. This credential check consumes no enrichment credit and returns X-Credits-Consumed: 0; it does not test company-data availability.

POST /api/v1/enrichment/company
Authorization: Bearer $ELVESORA_API_KEY
Idempotency-Key: enrich-acme-001
Content-Type: application/json

{
  "domain": "acme.com"
}

Success response

Read result_type first, then map only the returned company fields your workflow needs.

{
  "success": true,
  "result_type": "ENRICHED",
  "message": "Company enrichment completed successfully",
  "data": {
    "company_name": "Acme Corporation",
    "legal_name": "Acme Corporation",
    "domain": "acme.com",
    "website_url": "https://acme.com",
    "company_description": "Industrial equipment manufacturer.",
    "industry": "Manufacturing",
    "sub_industry": "Industrial Equipment",
    "sector": "Industrials",
    "hq_city": "Chicago",
    "hq_region": "Illinois",
    "hq_country": "United States",
    "employee_count": 1200,
    "contacts": {
      "emails": ["info@acme.com"],
      "phones": ["+1-312-555-0100"]
    },
    "tech_stacks": [],
    "competitors": []
  },
  "credits": {
    "limit": 100,
    "used": 5,
    "remaining": 95,
    "consumed_by_request": 1,
    "period_started_at": "2026-06-01",
    "period_ends_at": "2026-07-01"
  },
  "remaining": 95,
  "limit": 100
}