Skip to main content
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