Interact with Pipedrive CRM via REST API. Use when checking deal pipeline, sales activity, contacts, organizations, or revenue data. Covers deals, persons, organizations, activities, pipelines, and stages.
Query and manage Pipedrive CRM data via REST API v1.
Requires PIPEDRIVE_API_TOKEN environment variable.
All requests append ?api_token=$PIPEDRIVE_API_TOKEN as a query parameter.
Base URL: https://api.pipedrive.com/v1
List your pipelines and stages to get IDs:
curl -s "https://api.pipedrive.com/v1/pipelines?api_token=$PIPEDRIVE_API_TOKEN"
curl -s "https://api.pipedrive.com/v1/stages?api_token=$PIPEDRIVE_API_TOKEN"
List open deals (with pagination):
curl -s "https://api.pipedrive.com/v1/deals?api_token=$PIPEDRIVE_API_TOKEN&status=open&limit=100&sort=update_time%20DESC"
Deals in a specific pipeline:
curl -s "https://api.pipedrive.com/v1/deals?api_token=$PIPEDRIVE_API_TOKEN&status=open&pipeline_id=PIPELINE_ID"
Deal summary (aggregate values):
curl -s "https://api.pipedrive.com/v1/deals/summary?api_token=$PIPEDRIVE_API_TOKEN&status=open"
Upcoming activities:
curl -s "https://api.pipedrive.com/v1/activities?api_token=$PIPEDRIVE_API_TOKEN&done=0&limit=50&sort=due_date%20ASC"
Recent activity (done in last 7 days):
curl -s "https://api.pipedrive.com/v1/activities?api_token=$PIPEDRIVE_API_TOKEN&done=1&limit=50&sort=due_date%20DESC"
Search persons/orgs:
curl -s "https://api.pipedrive.com/v1/persons/search?api_token=$PIPEDRIVE_API_TOKEN&term=NAME"
curl -s "https://api.pipedrive.com/v1/organizations/search?api_token=$PIPEDRIVE_API_TOKEN&term=NAME"
Get specific deal with details:
curl -s "https://api.pipedrive.com/v1/deals/DEAL_ID?api_token=$PIPEDRIVE_API_TOKEN"
Deals updated recently (stale deal detection):
curl -s "https://api.pipedrive.com/v1/deals?api_token=$PIPEDRIVE_API_TOKEN&status=open&sort=update_time%20ASC&limit=100"
title — deal namevalue / currency — monetary valuestatus — open, won, lost, deletedstage_id — current stagepipeline_id — which pipelineadd_time / update_time — timestampsowner_name — assigned toorg_name / person_name — linked org/contactexpected_close_date — forecasted closeweighted_value — probability-adjusted valueResponses include additional_data.pagination:
more_items_in_collection — booleannext_start — offset for next pagelimit — items per page (max 500)Append &start=N for next page.
80 requests per 2 seconds per API token. For bulk queries, add small delays.