Developer API

Build with Prospectory

Integrate directly with Prospectory's tenant-scoped API for Lead Packs, Account Intelligence, sandbox testing, and MCP-enabled agent workflows.

Get API KeyOpenAPI Spec
Base URL
api.prospectory.ai
Auth
API Key
Scope
Per workspace
Format
JSON

Lead Packs

Create, list, update, and delete lead-pack containers used by Prospectory campaigns and integrations.

Account Intelligence

Create companies, retrieve enriched snapshots, and request async sync or AI enrichment workflows.

MCP server

Connect AI agents through the Prospectory MCP endpoint backed by the same tenant-scoped API services.

Quickstart

1

Create or choose an API key

Generate a server-side key in Prospectory and store it outside client-side code.

2

Start in sandbox

Use the sandbox base URL to validate request shapes without touching production workspace data.

3

Create Account Intelligence records

POST to /intelligence-companies with company names and websites. Enrichment starts asynchronously.

4

Poll for enrichment

Read records by ID until status moves from NOT_FETCHED to FOUND or NOT_FOUND.

5

Connect agents through MCP

Point an MCP client at /api/v1/mcp with the same x-api-key header to use the tool catalog.

Resource Map

Product names, REST paths, and MCP tools intentionally map to the same tenant-scoped resources.

App feature
Lead Packs
REST path
/lead-packs
MCP tools
prospectory_list_lead_packs, prospectory_get_lead_pack, prospectory_create_lead_pack

Lead-pack containers organize leads for campaigns and integrations.

App feature
Account Intelligence
REST path
/intelligence-companies
MCP tools
prospectory_list_account_intelligence, prospectory_get_account_intelligence, prospectory_create_account_intelligence, prospectory_sync_account_intelligence

The path keeps the historical API name, but the product feature is Account Intelligence.

App feature
MCP Server
REST path
/mcp
MCP tools
tools/list, tools/call

JSON-RPC endpoint for MCP clients and AI agents, backed by the same tenant-scoped services.

Authentication

Public API requests use the x-api-key header. Keys are tenant-scoped, server-side credentials that restrict reads and writes to the issuing Prospectory workspace.

curl
curl -X GET "https://api.prospectory.ai/api/v1/lead-packs" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json"

Production

https://api.prospectory.ai/api/v1

Sandbox

https://api.prospectory.ai/api/sandbox/v1

Returns dummy data for testing

Access Control

Public API keys are workspace-scoped. The API never returns resources from another Prospectory tenant.

API keys are scoped to one Prospectory workspace.

List and detail endpoints only return resources owned by that workspace.

Write endpoints create, update, sync, or delete resources inside that workspace only.

Use the sandbox base URL for integration tests that should not affect production data.

API Reference

Health Check

Monitor system health and infrastructure status.

Available

Prospectory MCP Server

Prospectory exposes an MCP server on top of the same tenant-scoped API contract so AI agents can safely read Lead Packs, inspect Account Intelligence records, and request approved enrichment workflows.

Endpoint
https://api.prospectory.ai/api/v1/mcp
Read Lead Packs
Inspect Account Intelligence
Request Enrichment

Available Tools

prospectory_list_lead_packs

List Lead Packs in the authenticated workspace.

prospectory_get_lead_pack

Retrieve one Lead Pack by ID.

prospectory_create_lead_pack

Create a Lead Pack container without starting outreach.

prospectory_list_account_intelligence

List Account Intelligence records with filters and pagination.

prospectory_get_account_intelligence

Retrieve one Account Intelligence record and snapshot.

prospectory_create_account_intelligence

Create Account Intelligence records and start async enrichment.

prospectory_sync_account_intelligence

Request sync or AI re-enrichment for selected records.

prospectory_delete_account_intelligence

Delete one Account Intelligence record after explicit confirmation.

Call a Tool

curl
curl -X POST "https://api.prospectory.ai/api/v1/mcp" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "prospectory_list_account_intelligence",
      "arguments": {
        "page": 1,
        "limit": 10,
        "status": "FOUND"
      }
    }
  }'

Initialize

curl
curl -X POST "https://api.prospectory.ai/api/v1/mcp" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": {
        "name": "example-agent",
        "version": "1.0.0"
      }
    }
  }'

List Tools

curl
curl -X POST "https://api.prospectory.ai/api/v1/mcp" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list"
  }'

Agent Safety Model

MCP uses the same workspace-scoped API key as REST. Read tools only see the authenticated workspace. Create and sync tools do not start campaigns, outreach, AI message generation, or Apollo imports. The delete tool is intentionally explicit and should only be called after user confirmation in the MCP client.

Error Handling

All errors follow a standardized format with error code, message, and optional details.

400VALIDATION_ERRORRequest validation failed
400BAD_REQUESTInvalid request format
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENInsufficient permissions
404NOT_FOUNDResource not found
429RATE_LIMIT_EXCEEDEDToo many requests
500INTERNAL_SERVER_ERRORServer error
503SERVICE_UNAVAILABLEService temporarily unavailable

Error Response Format

json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Human-readable description",
    "details": {
      "field": "Additional context"
    }
  },
  "timestamp": "2024-01-15T10:30:00Z",
  "path": "/api/v1/lead-packs"
}

Ready to integrate?

Get your API key and start building against Prospectory's tenant-scoped public API.

Get StartedContact Sales