Developer Docs
REST API
Give your AI agent or application direct HTTP access to live lower middle market M&A deals and AI-generated buyer lists.
Endpoints under /buyer return buyer-perspective data.
Natural language filters, predictable JSON, and an OpenAPI spec your agent can read directly.
Getting Started
All requests require a Bearer token in the Authorization header.
curl https://api.privsource.com/v1/whoami \ -H "Authorization: Bearer YOUR_API_TOKEN"
Endpoints
Account
Available with any active API key.
| Method | Path | Description |
|---|---|---|
| GET | /v1/whoami | Get current account context |
Deals
Available to all buyers with a paid subscription.
| Method | Path | Description |
|---|---|---|
| GET | /v1/buyer/deals | List deals |
| GET | /v1/buyer/deals/:id | Get a deal |
Buyer Lists
BetaAvailable to sellers with a paid subscription.
| Method | Path | Description |
|---|---|---|
| GET | /v1/buyer-lists | List Buyer Lists |
| POST | /v1/buyer-lists | Create a Buyer List |
| GET | /v1/buyer-lists/:id | Get a Buyer List |
| PATCH | /v1/buyer-lists/:id | Update a Buyer List |
| GET | /v1/buyer-lists/:id/current | Get the current Buyer List version |
| GET | /v1/buyer-lists/:id/:version_number | Get a specific Buyer List version |
| PATCH | /v1/buyer-lists/:id/criteria | Update Buyer List criteria |
| POST | /v1/buyer-lists/:id/generate | Generate a Buyer List |
| POST | /v1/buyer-lists/:id/cancel | Cancel a Buyer List build |
| POST | /v1/buyer-lists/:id/refine | Refine a Buyer List |
| GET | /v1/buyer-lists/:id/results | List Buyer List results |
| POST | /v1/buyer-lists/:id/results/:result_id/feedback | Update feedback on a Buyer List result |
| POST | /v1/buyer-lists/:id/contact-info | Request Buyer List contact info |
Base URL
https://api.privsource.com/v1
Rate Limits
API requests are limited to 60 requests per minute per API token.
Exceeding this limit returns a 429 status with a Retry-After header.
Instructions for your agent
Copy and paste this into your AI agent. Your agent will fetch the public OpenAPI spec and discover all available endpoints automatically.
# PrivSource Agents API You have access to the PrivSource Agents API. Use it to search live lower middle market M&A deal listings and generate Buyer Lists. Paths under `/buyer` return data from the buyer perspective. Deals endpoints are available to buyers with a paid subscription; Buyer Lists endpoints (beta) are available to sellers with a paid subscription. Call `GET /v1/whoami` to check which APIs your token can access. ## Base URL ``` https://api.privsource.com/v1 ``` ## Authentication All requests require a Bearer token in the `Authorization` header: ``` Authorization: Bearer YOUR_API_TOKEN ``` ## OpenAPI Spec Fetch the public OpenAPI spec: ``` curl https://api.privsource.com/agents-api/v1/spec.json ``` Use this spec to discover all available endpoints and parameters.
Terms of Use
The PrivSource REST API is provided exclusively for internal use by paying PrivSource customers. Data accessed through the API may not be repackaged, resold, redistributed, or repurposed for any external product or service. Use of the API is subject to the PrivSource Terms of Service.