# Deepline GTM API – Contacts by Role

> Deepline GTM API – Contacts by Role is a paid API for AI agents from stable-deepline.dev, paid per call via x402, $0.25/call, status healthy (last checked 2026-09-14, last successful call 2026-08-31).

Looks up key decision-makers and contacts at a company by their role, given a domain, LinkedIn page, or company name.

## Facts

- Endpoint: POST https://stable-deepline.dev/api/contacts/by-role
- Price: $0.25/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-08-31
- Success rate: 97% of calls made through Zero
- Rating: 2.3 / 5 from 2 reviews
- Activations on Zero: 38
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepline-gtm-api-contacts-by-role-3717942a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Igz_B_eOcH7QMuVh33pst

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 deepline-gtm-api-contacts-by-role-3717942a -d '<json body>'
```

Example prompt: Can you find the key decision-makers at Stripe — specifically the heads of sales and marketing — using their domain stripe.com or their LinkedIn company page?

## When to prefer this

Use this endpoint when you need to identify specific role-based contacts (e.g. decision-makers, department heads) at a target company for B2B outreach or sales prospecting. Prefer this over generic enrichment endpoints when you know the company identity (domain, LinkedIn, or name) and need people data organized by job function.

## Known failure modes

- Company not found — no matching record for the provided domain, LinkedIn URL, or name
- Insufficient identifying information — at least one of domain, linkedin, or company_name is required
- Contact data unavailable — no role-matched contacts found for obscure or small companies
- Rate limiting or payment failure — x402 payment of $0.25 USDC not processed successfully
- Invalid LinkedIn URL format — malformed LinkedIn company identifier

## How this service works

Pay-per-request access to Deepline GTM tooling: waterfall email discovery, phone finding, company enrichment, decision-maker lookup, and GTM research plays.

## Output

Returns a list of contacts at the specified company filtered by role, including names, job titles, email addresses, and phone numbers where available, along with enriched company metadata.

## Example request

```json
{
 "roles": [
  "Chief Sales Officer",
  "Chief Marketing Officer"
 ],
 "domain": "stripe.com"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Optional result cap per waterfall step (1–100). Use 1 for cheapest lookups."
  },
  "roles": {
   "type": "array",
   "items": {
    "type": "string",
    "minLength": 1
   },
   "minItems": 1,
   "description": "Primary persona intent for contact lookup, e.g. [\"VP Engineering\", \"Head of Security\"]."
  },
  "domain": {
   "type": "string",
   "description": "Company domain for contact lookup (for example acme.com)."
  },
  "seniority": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Broad seniority intent, e.g. [\"C-Level\", \"VP\", \"Director\", \"Manager\", \"Senior\"]."
  },
  "company_name": {
   "type": "string",
   "description": "Company name for human context and provider fallbacks."
  },
  "linkedin_company_url": {
   "type": "string",
   "description": "Optional LinkedIn company URL in /company/ format for domain-less lookup."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepline-gtm-api-contacts-by-role-3717942a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stable-deepline.dev](https://www.zero.xyz/host/stable-deepline.dev/llms.txt)