Less boo. More booked. Halloween offer: 30 days free on any paid plan. Claim 30 days freeEvery new account gets one free mailbox for warmup and replies. No domain to buy. See how it works

Skip to content

The company object

API referenceLeads

From the Leads API reference. Requests use the base URL https://app.warmerly.com/api/v1 and an API key, see Authentication.

json
{
  "id": "b1e6a2c4-9f3d-4a7e-8c1b-2d5f9a3e7c6b",
  "domain": "northwindtraders.com",
  "companyName": "Northwind Traders",
  "legalName": "Northwind Traders Ltd",
  "description": "Wholesale importer of specialty foods.",
  "websiteUrl": "https://northwindtraders.com",
  "country": "GB",
  "city": "Manchester",
  "region": "Greater Manchester",
  "streetAddress": "14 Dock Street",
  "postalCode": "M1 2AB",
  "phone": "+441611234567",
  "orgType": "Wholesaler",
  "industry": null,
  "techStack": ["shopify", "klaviyo"],
  "emailProvider": "google",
  "linkedinUrl": "https://www.linkedin.com/company/northwind-traders",
  "twitterUrl": null,
  "socialUrls": ["https://www.facebook.com/northwindtraders"],
  "inferredCategoryId": null,
  "companyNumber": null,
  "companyNumberJurisdiction": null,
  "vatNumber": null,
  "employeeCount": null,
  "employeeBand": null,
  "hiringSignal": false,
  "careersUrl": null,
  "contactFormUrl": null,
  "openingHours": null,
  "foundedYear": null,
  "currencies": null,
  "contactEmail": "info@northwindtraders.com",
  "allEmails": ["info@northwindtraders.com", "sales@northwindtraders.com"],
  "crawledAt": "2026-08-10T04:22:00.000Z"
}

Most fields can be null when the company does not publish them. inferredCategoryId is a display-only guess made from the company's own text when it declares no business type, and is null whenever the guess is not confident. It is not a declared fact and is never exported.

contactEmail is the first of allEmails, kept separate because export and push-to-campaign both key off a single address per company. Deliverability signals (MX/SPF/DMARC) are deliberately not exposed on this object, they're Warmerly's own outreach data, not customer-facing.

Was this page helpful?