Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.leadx.com/llms.txt

Use this file to discover all available pages before exploring further.

The fastest way to confirm your API key works is with cURL. In this tutorial, you’ll call the LeadX API to fetch company details.
1

Save Your API Key

Set your key as an environment variable:
Terminal
export LEADX_API_KEY="your_api_key_here"
2

Make a Request

Call the /companies endpoint with any company URL:
Terminal
curl -X POST "https://api.leadx.com/v1/companies" \
  -H "X-API-KEY: $LEADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example-company.com"}' | jq
You can optionally use | jq in the request. This will format the JSON response in a human-readable way directly in the terminal. Make sure you have jq installed on your system (brew install jq on macOS).
3

View the Response

If everything is set up correctly, the API will respond with a 200 status code, which is your confirmation the request was successful.Along with the status, you’ll get rich JSON data describing the company, including:
  • Company name
  • Address
  • Industry classification
  • Social profiles
  • NAICS/SIC codes
200 - Successful Response
{
  "success": true,
  "records": [
    {
      "about_link": "http://acme-corp.com/about-us/",
      "address_full": "123 Any Street, Any Town, PA, 12345, United States",
      "city": "Any Town",
      "company_id": "ABCD1EF2GHIJKLMNO3QRST",
      "company_name": "Acme Corp",
      # ... you'll see more data displayed here
    }
  ],
  "total_records": 1
}

​
Next Steps

Congratulations!You’ve verified your API key and pulled your first company record. From here, you can:
  • Try a new endpoint: Look up executives, validate emails, or enrich a contact with /contacts or /emails/validation.
  • Chain calls together: Build lightweight workflows, like automating KYC checks or enriching sales leads. Check out the other tutorials in this section for more ideas.
PreviousUCC Secured PartyNextPerform a Credit Risk Assessment
Last modified on March 23, 2026