# Company Contacts API

> Company Contacts API is a paid API for AI agents from companyfacts.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Fetches contact information (phone numbers, emails, address, contact page) for a company given its domain name.

## Facts

- Endpoint: GET https://companyfacts.dev/x402/v1/company-contacts?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/company-contacts-api-cd557400
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V041epr7JcKEN60GGlljW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability company-contacts-api-cd557400
```

Example prompt: Can you pull up the contact details for example-dental.com — I need their phone number, email addresses, and mailing address?

## When to prefer this

Use this endpoint when you need real, crawled contact data (phone, email, address) for a specific company given its domain — especially for B2B sales enrichment, building contact directories, or verifying publicly listed business information. Prefer this over generic web search when you need structured, parsed contact fields rather than raw search results, and when you have the company domain available as input.

## Known failure modes

- Domain not found or not crawlable — returns empty arrays or null fields
- Company has no publicly listed contact information — returns empty phones/emails
- Ambiguous or parked domain — may return minimal or no data
- Network timeout fetching the company's website — may return partial results
- Invalid domain format in query parameter — likely returns a 400 error

## How this service works

Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.

## Output

Returns a JSON object with the company's domain, phone numbers (with source URLs), physical address (street, city, region, postal code, country, source URL), role-based emails (e.g. frontdesk@), other emails (e.g. staff), contact page URL, list of pages read during extraction, a US company flag, fetch timestamp, and any notes. All contact data includes the source URL where it was found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "domain"
     ],
     "properties": {
      "domain": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "notes": [],
  "domain": "example-dental.com",
  "phones": [
   {
    "number": "+1 512-555-0142",
    "source_url": "https://example-dental.com/contact"
   }
  ],
  "address": {
   "city": "Austin",
   "region": "TX",
   "street": "100 Main St",
   "country": "US",
   "source_url": "https://example-dental.com/",
   "postal_code": "78701"
  },
  "fetched_at": "2026-10-30T18:00:00.000Z",
  "pages_read": [
   {
    "url": "https://example-dental.com/",
    "kind": "home"
   },
   {
    "url": "https://example-dental.com/contact",
    "kind": "contact"
   }
  ],
  "us_company": true,
  "role_emails": [
   {
    "email": "frontdesk@example-dental.com",
    "source_url": "https://example-dental.com/contact"
   }
  ],
  "contact_page": "https://example-dental.com/contact",
  "other_emails": [
   {
    "email": "dr.lee@example-dental.com",
    "source_url": "https://example-dental.com/team"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/company-contacts-api-cd557400/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companyfacts.dev](https://www.zero.xyz/host/companyfacts.dev/llms.txt)