OneSource API

The Identity and Enrichment API Behind Your GTM Stack

OneSource is the data enrichment and identity resolution layer for the iCustomer platform. A single REST API that waterfalls through multiple providers, resolves cryptographic identities, and maintains a live knowledge graph. 1 credit per hit. Cache hits are free. Bring your own API keys.

Get API Key Read the Docs

Five Surfaces, One API

Access enrichment and identity resolution from anywhere in your stack.

REST API

Direct HTTP endpoints for contact enrichment, company lookup, identity resolution, and credit management. Authenticated via api-key header. Go-powered, sub-200ms response times.

Waterfall Enrichment

Every request cascades through providers in priority order: oGraph cache, ReverseContact, TrestleIQ, Apollo, PDL. First confident hit wins. 1 credit per match. Cache hits are free.

Bring Your Own Key (BYOK)

Inject your own Apollo or PDL API keys via HTTP headers. OneSource orchestrates the waterfall using your keys and quotas. Keep your existing vendor contracts and pricing.

Identity Resolution

Deterministic Digital Identity Documents (DIDs) via HMAC-SHA256. Golden Records per tenant, Universal DIDs across tenants. The same person in Salesforce, HubSpot, and LinkedIn always resolves to the same entity.

CLI for Developers

Terminal-first enrichment with onesource-cli. Single-record lookup, CSV batch enrichment, JSONL pipe streaming, scheduled jobs, and pre-built plays for lead qualification and champion tracking.

MCP for AI Agents

8 MCP tools for Claude Desktop: enrich_contact, enrich_company, prospect_people, prospect_companies, find_lookalikes, research, lookup, and get_credits. Natural language enrichment built in.

Cache-First Architecture

The oGraph is a PostgreSQL knowledge graph that stores every enriched entity. When a contact or company is requested, oGraph is checked first. Cache hits return instantly with zero credit cost. Over time, your intelligence compounds: the more you enrich, the more free lookups you get. External providers are only called when the cache cannot satisfy the request.

oGraphCache Hits FreeIntelligence Compounds

Explore API Enrichment

Media placeholder

Your Keys, Our Orchestration

Already paying for Apollo or People Data Labs? Pass your API keys via X-Apollo-Api-Key or X-PDL-Api-Key headers. OneSource orchestrates the waterfall, deduplication, and identity resolution using your keys. Customize provider priority with the X-Waterfall-Order header. You keep your vendor relationships. We add the intelligence layer.

BYOKNo Vendor Lock-InCustom Waterfall Order

Learn about BYOK

Media placeholder

Built for Production

Credit per enrichment hit

For cache hits (oGraph)

Microservices (Go, TS, Python)

MCP tools for AI agents

Enrich Your First Contact in 60 Seconds

Get your API key, send a POST to /v2.1/contact/enrich, and receive enriched data back. 1 credit per hit. Cache hits are free. No minimum spend.

Get API Key View Documentation