# Bytemine Contact Enrichment

> Bytemine Contact Enrichment is a paid API for AI agents from agents.bytemine.ai, paid per call via MPP, $0.01/call, status healthy (last checked 2026-09-15, last successful call 2026-09-02).

Enriches a contact record by looking up a person via email, phone, LinkedIn URL, or other identifiers and returning additional profile and contact data.

## Facts

- Endpoint: POST https://agents.bytemine.ai/functions/v1/api-gateway/contacts/enrich
- Price: $0.01/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-09-15
- Last successful call: 2026-09-02
- Success rate: 67% of calls made through Zero
- Activations on Zero: 9
- Provider: agents.bytemine.ai
- Website: https://agents.bytemine.ai
- Canonical page: https://www.zero.xyz/c/agents-bytemine-ai-bytemine-contact-enrichment-39d06e58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_apP5CO6dpH3sElX233k7E

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 agents-bytemine-ai-bytemine-contact-enrichment-39d06e58 -d '<json body>'
```

Example prompt: Enrich this contact for me — their LinkedIn is linkedin.com/in/jane-smith-acme, and I also have their email jane.smith@acme.com. I need their work email, personal email if available, and a cell phone number.

## When to prefer this

Use this endpoint when you have at least one identifier for a person (email, phone, LinkedIn URL, or name+company) and need to expand their contact record with additional details like work email, personal email, or phone number. Prefer this over contact search when you already know who you are looking for and just need to fill in missing fields. Bill is only incurred on a successful match, making it low-risk for validation workflows.

## Known failure modes

- No match found for the provided identifiers — returns empty or null enrichment result
- Invalid or malformed email/LinkedIn URL input causes a validation error
- Insufficient identifying information (e.g. only a first name) leads to no match
- Rate limiting or payment authorization failure blocks the request
- Requested fields (e.g. hasWorkEmail) not available for the matched contact

## How this service works

Look up and enrich a single contact by email, phone, LinkedIn URL, or name plus company. Any one lookup field is sufficient. Returns the full profile including work email, phone, job title, and company info. An email finder fallback runs automatically when no work email is on file, at no extra charge. Billed only on a successful match. US phone numbers are auto normalized from any common format.

## Output

Returns an enriched contact object including available fields such as work email, personal email, phone number, direct dial, local address, LinkedIn URL, and primary contact designation, billed only on a successful match.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "email": {
   "type": "string",
   "description": "Email address to look up."
  },
  "phone": {
   "type": "string",
   "description": "Phone number to look up."
  },
  "facebook": {
   "type": "string",
   "description": "Facebook profile URL."
  },
  "hasPhone": {
   "type": "boolean"
  },
  "lastName": {
   "type": "string"
  },
  "linkedin": {
   "type": "string",
   "description": "LinkedIn profile URL to look up."
  },
  "firstName": {
   "type": "string"
  },
  "companyName": {
   "type": "string"
  },
  "hasPhoneCell": {
   "type": "boolean"
  },
  "hasWorkEmail": {
   "type": "boolean",
   "description": "Request work email in results."
  },
  "companyDomain": {
   "type": "string"
  },
  "hasDirectDial": {
   "type": "boolean"
  },
  "hasLocalAddress": {
   "type": "boolean"
  },
  "hasPersonalEmail": {
   "type": "boolean",
   "description": "Request personal email in results."
  },
  "hasPrimaryContact": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-bytemine-ai-bytemine-contact-enrichment-39d06e58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.bytemine.ai](https://www.zero.xyz/host/agents.bytemine.ai/llms.txt)