# Get Contact by ID

> Get Contact by ID is a paid API for AI agents from agents.bytemine.ai, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieve the full profile of a specific contact by their unique contact ID from Bytemine's 135M-professional database.

## Facts

- Endpoint: GET https://agents.bytemine.ai/functions/v1/api-gateway/contacts/{contactId}
- Price: $0.01/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: agents.bytemine.ai
- Website: https://agents.bytemine.ai
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-bytemine-ai-get-contact-by-id-0424f59d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZElFNk1CwH4bts87oks4z

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-get-contact-by-id-0424f59d
```

Example prompt: Pull up the full Bytemine contact profile for contact ID cnt_9f3a21b7 — I need all the details we have on this person.

## When to prefer this

Use this endpoint when you already have a Bytemine contact ID (e.g. from a prior search or import) and need the complete profile in a single call. It is faster and cheaper than running a full contact search when the ID is known. Prefer this over the bulk enrichment endpoint for single-contact lookups where you have the native ID rather than an email or LinkedIn URL.

## Known failure modes

- Contact ID not found — returns a 404 or empty data object if the ID does not exist in the database
- Invalid contact ID format — malformed ID strings may return a 400 error
- Payment failure — if the $0.01 charge cannot be processed, the request is rejected
- Network timeout — the upstream Bytemine API may occasionally be slow or unavailable
- Partial profile — some contacts may have incomplete data, returning fewer fields than expected

## How this service works

Bytemine is a B2B data platform for sales and go to market teams. It covers contact and company search across 135M professionals and 10M companies, contact and company enrichment, LinkedIn profile search and enrichment, live company intelligence read from a company's own web presence, technographics, buying intent scoring, and hiring, funding, job posting, and job change signals. Search results bill per record returned, enrichment bills only on a successful match, and count queries are free. This server is a pay-per-use, transparent proxy in front of Bytemine's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. This document is the source of truth for agents: it lists the complete verified paid surface with each operation's live price in its x-payment-info. Endpoints not listed here are not part of the supported catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.

## Output

Returns a JSON object with a `data` field containing the contact's full profile, which may include name, email addresses, phone numbers, job title, company name, LinkedIn URL, location, seniority, department, and other professional attributes available in Bytemine's database for that contact.

## 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"
    },
    "pathParams": {
     "type": "object",
     "contactId": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "description": "Full contact profile."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-bytemine-ai-get-contact-by-id-0424f59d/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)