{"uid":"cap_Igz_B_eOcH7QMuVh33pst","slug":"deepline-gtm-api-contacts-by-role-3717942a","name":"Deepline GTM API – Contacts by Role","description":"Pay-per-request access to Deepline GTM tooling: waterfall email discovery, phone finding, company enrichment, decision-maker lookup, and GTM research plays.","url":"https://stable-deepline.dev/api/contacts/by-role","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":{"request":{"roles":["Chief Sales Officer","Chief Marketing Officer"],"domain":"stripe.com"},"response":{"run":{"id":"play/prebuilt-company-to-contact/run/20260618t062123-358","status":"completed","playName":"prebuilt/company-to-contact","startedAt":1781763683591,"updatedAt":1781763690308,"durationMs":6717,"finishedAt":1781763690308},"kind":"play_run","logs":{"tail":[],"totalCount":0},"next":{"billing":{"api":{"path":"/api/v2/runs/play%2Fprebuilt-company-to-contact%2Frun%2F20260618t062123-358?full=true","method":"GET"},"kind":"deepline_run_billing","runId":"play/prebuilt-company-to-contact/run/20260618t062123-358"},"inspect":{"api":{"path":"/api/v2/runs/play%2Fprebuilt-company-to-contact%2Frun%2F20260618t062123-358","method":"GET"},"kind":"deepline_run_inspect","runId":"play/prebuilt-company-to-contact/run/20260618t062123-358"}},"steps":[{"id":"company_to_contact_by_role_waterfall_steps","kind":"step","status":"completed"}],"outputs":{"company_to_contact_by_role_waterfall":{"kind":"value","path":"result.company_to_contact_by_role_waterfall","value":[{"email":null,"title":null,"linkedin":"https://www.linkedin.com/in/jeff-titterton-46300a1","full_name":"jeff titterton"},{"email":null,"title":null,"linkedin":"https://www.linkedin.com/in/dana-tedeschi-b7750849","full_name":"dana tedeschi"}]}},"schemaVersion":1}},"exampleRequest":{"roles":["Chief Sales Officer","Chief Marketing Officer"],"domain":"stripe.com"},"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.33","successRate":"0.97","reviews":2,"stars":"2.3","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"25.0000","medianCents":"25.0000","p90Cents":"25.0000","minCents":"25.0000","maxCents":"25.0000","p95Cents":"25.0000","sampleCount":20,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K6BNjU6yPpe-p_egFUDzH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up key decision-makers and contacts at a company by their role, given a domain, LinkedIn page, or company name.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":38,"lastUsedAt":"2026-08-31T21:58:34.854Z","lastSuccessfullyRanAt":"2026-08-31T21:58:34.854Z","lastHealthCheckAt":"2026-09-14T18:54:08.384Z","isFirstParty":false}