API docs

Use GetProspect from your AI assistant

Connect Claude, ChatGPT, Cursor, VS Code and other AI assistants to the GetProspect MCP server at https://api.getprospect.com/mcp and sign in with GetProspect, no API key needed. Searches are free, and bigger paid steps show the cost and ask you first.

Set up the MCP server or see what it can do.

Our API is designed to be integrated in minutes:

• Simple and clear JSON responses
• Consistent response envelope across all endpoints
• API key authentication with a single header
• Credit-based pricing - you only pay for revealed data
• Machine-readable OpenAPI specification, plus a markdown twin of every docs page (append .md to its URL)

Get started

• Authentication - authenticate your requests and understand the request format
• Credits and rate limits - understand how credits are spent
• Pagination - page through search results
• Errors - error envelope and status codes
• Integration best practices - retries, credit control, bulk endpoints and pacing for automated integrations

AI assistants (MCP)

• MCP server - connect Claude, ChatGPT, Cursor and other AI assistants to GetProspect: 17 tools, credit quotes before spend, and setup steps for each client

Search endpoints

• People Search - search the people index with structured filters
• Company Search - search the companies index
• Search Suggestions - typeahead values for the location, job title and industry filters
• Smart Job Titles - AI-suggested job titles that widen a People Search, with how many people each adds

Enrich endpoints

• People Enrich - enrich a person with full profile data
• People Bulk Enrich - enrich up to 50 people per request
• Company Enrich - enrich a company with full profile data
• Company Bulk Enrich - enrich up to 50 companies per request
• Email Finder - find a work email by name and company
• Email Verifier - verify the deliverability of an email

Object schemas

• Person object and Company object - the shapes returned by the search, enrich and get endpoints
• List object - the shape returned by the list endpoints

Enums

• Enums - the allowed values of every enum filter (industries, departments, seniorities, countries and more), one page per enum

More endpoints

For workflows built on your workspace's saved records, and for the plumbing around them. Most integrations need only search and enrich.

Lists

• Create List - organize saved people and companies into named lists, with how to fill a list, read what is in it and handle a taken name
• List, get, rename and delete lists; add and remove people, remove companies, and set the lists of many people or companies at once

Saved records

• Get Person and Get Company - read one record by id, with your workspace's saved state
• Save People - save up to 500 people into your lists
• Preview Save Credits - price a save before you run it, free
• Save Companies - save companies, optionally into company lists

Bulk jobs

• Bulk jobs: poll or webhook - enrich up to 10,000 people or companies, or verify up to 10,000 emails, in one async job: create it, poll it or get a job.finished webhook, then page the results (and the bulk email finder recipe)
• Create People Enrichment, Create Company Enrichment, get, list and cancel enrichments, and read their results
• Create Email Verification, get, list and cancel verifications, and read their results

Blocklist

• People and companies your workspace never wants to see in search, enrich or email find: list, block and unblock

Jobs and account

• Get Job - poll any async job by id
• Get Current User - who a credential belongs to and the workspace it acts in
• Get Credit Balances - the live balance of each credit type

Webhooks

• Create Webhook - get a signed POST at your URL when a person or company is saved, an email is found or a bulk job finishes, with the event types, the signature check and the retry schedule
• List, get, update and delete webhooks, send a test event and list deliveries

Events

• Stream Events - a realtime stream of your workspace's notifications and credit, subscription and integration changes