# Leadspace

> Leadspace is a B2B GTM Data Intelligence Cloud and customer data platform. It unifies buyer, account, and intent data into the Leadspace Universal Graph (v4) and exposes it as an enrichment API: submit a partial person or company record and receive a resolved entity with firmographics, corporate hierarchy, department sizes, funding, technology signals, buyer intent, and persona/predictive scores. All API access is over HTTPS with a bearer token issued per program.

Generated by API Evangelist, updated 2026-08-13, from Leadspace's published help-center documentation, product site, and live probes. Leadspace publishes no llms.txt of its own and no machine-readable OpenAPI; the specs linked below were generated faithfully from the published technical specifications.

## Agent access (MCP)

- Leadspace runs a hosted remote MCP server at `https://skprod.leadspace.com/mcp/v1`. It is the fastest agent-facing path into the Leadspace data graph and does not require an enterprise contract.
- Auth is OAuth 2.1 authorization-code + PKCE against an Auth0 tenant, with dynamic client registration — in Claude or ChatGPT, paste the URL and leave the OAuth client fields blank, then sign in with a Leadspace account.
- Claude Code: `claude mcp add --transport http leadspace https://skprod.leadspace.com/mcp/v1`
- [Leadspace MCP](https://www.leadspace.com/solutions/leadspace-mcp) · [Claude setup](https://www.leadspace.com/solutions/leadspace-mcp/claude) · [ChatGPT setup](https://www.leadspace.com/solutions/leadspace-mcp/chatgpt)
- The live `tools/list` manifest is auth-gated (401 with an RFC 9728 Bearer challenge). The only tool name Leadspace publishes is `enrich_account`; the rest of the surface is described as capabilities — company and contact lookup, reveal business email, reveal phone, buying intent signals.
- Metering: lookups are free; reveal email 1 credit, reveal phone 3 credits, buying intent 1 credit per company. Re-revealing something already unlocked is free. A free Starter account is capped at 25 credits/day.
- This is a DIFFERENT product from the v4 gateway API below, with a different credential. A Program ID does not authenticate the MCP server and an MCP token does not call apigw.leadspace.com.

## APIs

- [Leadspace Enrichment API v4](https://support.leadspace.com/hc/en-us/articles/23687993264284-Leadspace-Single-Direct-API-v4-Technical-Specifications): Single and bulk person/company enrichment against the Universal Graph. Base URL https://apigw.leadspace.com
- [Leadspace Bulk API v4](https://support.leadspace.com/hc/en-us/articles/23687991628572-Leadspace-Bulk-API-v4-Technical-Specifications): Up to 500 records per POST, retrieved by polling or callback
- [Leadspace Discovery API](https://support.leadspace.com/hc/en-us/articles/360011926619-Leadspace-Discovery-API): Expand up to 500 accounts into ranked net-new contacts
- [Leadspace Intent Only API](https://support.leadspace.com/hc/en-us/articles/360012583400-Leadspace-Intent-Only-API): Refresh buyer-intent topics and model scores for accounts

## Authentication

- [API v4 OAuth 2.0 Diagram](https://support.leadspace.com/hc/en-us/articles/360000827409-API-v4-OAuth-2-0-Diagram): Username-password flow at POST https://apigw.leadspace.com/oauth/authorize with audience API_GATEWAY; tokens expire every 24 hours and are refreshed with PUT to the same endpoint
- Perpetual token: `Authorization: Bearer API_KEY`. Rotate every 6 months; hard expiry at 2 years.

## Specs

- [Authorization OpenAPI](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/openapi/leadspace-authorization-api-openapi.yml)
- [Enrichment OpenAPI](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/openapi/leadspace-enrichment-api-openapi.yml)
- [Discovery OpenAPI](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/openapi/leadspace-discovery-api-openapi.yml)
- [Intent OpenAPI](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/openapi/leadspace-intent-api-openapi.yml)
- [Results OpenAPI](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/openapi/leadspace-results-api-openapi.yml)

## Operating rules

- Data format is JSON (RFC 7159); timestamps are ISO 8601 in UTC.
- Account enrichment requires Company Name. Person enrichment requires First Name, Last Name, and one of Company Name, Email Address, or Website.
- Single API is capped at 30 transactions per second per the customer's tiered SLA. Exceeding it returns HTTP 429.
- HTTP 427 signals insufficient credits or an invalid program ID. It is terminal, not retriable — contact the CSM or support@leadspace.com.
- There is no idempotency key. `external_id` and `external_bulk_id` are correlation-only and are not used for processing, so a retry re-consumes credits. Prefer polling an existing bulk over resubmitting it.
- Bulk jobs return 202 with a polling URI. Poll with GET: 200 means results are ready, 204 means still processing, 404 means results not found.
- Supply an optional `callbackUrl` on a bulk submission to receive a completion POST with bulkId, pollingUrl, bulkStatus (COMPLETED / INSUFFICIENT_CREDITS / INTERNAL_ERROR), and per-record counts.
- Errors use a proprietary JSON envelope: `error`, `tracking_id`, `request_timestamp`, `details`. Not RFC 9457.
- Record-level failures inside a successful bulk carry code 1100 (Internal Error, retriable) or 1200 (Invalid Input, not retriable as submitted).

## Artifacts

- [Authentication profile](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/authentication/leadspace-authentication.yml)
- [API conventions](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/conventions/leadspace-conventions.yml)
- [HTTP error catalog](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/errors/leadspace-problem-types.yml)
- [Record-level error codes](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/errors/leadspace-error-codes.yml)
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/rate-limits/leadspace-rate-limits.yml)
- [Lifecycle and versioning](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/lifecycle/leadspace-lifecycle.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/data-model/leadspace-data-model.yml)
- [Callbacks and webhooks](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/asyncapi/leadspace-callbacks-webhooks.yml)
- [Conformance and compliance](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/conformance/leadspace-conformance.yml)
- [Embedded components](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/components/leadspace-components.yml)
- [Agent skills](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/skills/_index.yml)
- [MCP server](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/mcp/leadspace-mcp.yml)
- [MCP to REST tool crosswalk](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/mcp/leadspace-tool-crosswalk.yml)
- [OAuth scopes](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/scopes/leadspace-scopes.yml)
- [Plans and pricing](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/plans/leadspace-plans-pricing.yml)
- [Packages and SDKs](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/packages/leadspace-packages.yml)
- [Well-known documents](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/well-known/leadspace-well-known.yml)
- [Trust center](https://raw.githubusercontent.com/api-evangelist/leadspace/refs/heads/main/security/leadspace-trust-center.yml)

## Docs

- [Leadspace Help Center](https://support.leadspace.com/hc/en-us)
- [Developer Guides](https://support.leadspace.com/hc/en-us/categories/5940743388306-Developer-Guides)
- [API section](https://support.leadspace.com/hc/en-us/sections/201997649-API)
- [Available Leadspace Fields and Custom Fields Guide](https://support.leadspace.com/hc/en-us/articles/360006155659-Available-Leadspace-Fields-and-Custom-Fields-Guide)
- [Release Notes](https://support.leadspace.com/hc/en-us/categories/7154652740626-Release-Notes)
- [Status page](https://status.leadspace.com/)
- [General Statement of Information Security and Privacy](https://support.leadspace.com/hc/en-us/articles/360012276859-General-Statement-of-Information-Security-and-Privacy)
- [Report a vulnerability](https://www.leadspace.com/report-a-vulnerability)

## Pricing

- [Sidekick and MCP pricing](https://www.leadspace.com/solutions/sidekick/pricing): Starter free forever (25 credits/day), Solo $49/user/mo billed annually (1,500 credits/mo), Pro $89 (3,500 credits/mo), Enterprise custom with full credit rollover and Advanced API. Credit packs available on all paid plans; annual billing saves 20%.
- The enterprise v4 gateway API is contracted per program with no published price; rate limits are a program-type tiered SLA in transactions per second.

## Optional

- [Leadspace Sidekick](https://chromewebstore.google.com/detail/leadspace-sidekick/mpckhfjjjghgkakcpfegdhkhomcondll): Chrome extension overlaying verified contact data, fit scoring and buying-group maps on LinkedIn and any web page
- [Leadspace Studio](https://studio.leadspace.com): hosted segment builder and contact discovery console
- [SmartForms](https://www.leadspace.com/products/leadspace-smartforms/): one-line JavaScript tag that enriches inbound web forms in real time
- [Leadspace SmartForms field dictionary](https://support.leadspace.com/hc/en-us/articles/360012057240-Leadspace-for-SmartForms-Field-Dictionary)