Skip to main content
The Activity API gives you a complete audit trail of every search and enrichment request you’ve made. Use it to review past work, find specific entities you’ve already accessed, and avoid paying repeat credits for data you already have.

​
Why Activity Matters

Every time you run a search or enrichment through the API, DealMachine logs it as an activity record. Each record captures:
  • What you requested — the full parameters (locations, filters, enrichment inputs)
  • What came back — summary stats and the entity IDs returned
  • What it cost — credits consumed, broken down by new vs. repeat
This means you can answer questions like:
  • “What searches have I run this month?”
  • “Have I already looked up this property or person?”
  • “Which of my searches used an equity filter?”
  • “Did I already enrich john@example.com?”
  • “What were the exact filters I used in that search last week?”
  • “Which entity IDs came back from a specific request?”

​
Activity Types

Every activity has a type that tells you which endpoint generated it:
TypeEndpointDescription
search_peoplePOST /v1/people/searchPeople/contact search
search_propertiesPOST /v1/properties/searchProperty search
count_peoplePOST /v1/people/search/countPeople count query
count_propertiesPOST /v1/properties/search/countProperty count query
enrich_emailPOST /v1/enrichment/emailEmail enrichment
enrich_phonePOST /v1/enrichment/phonePhone enrichment
enrich_addressPOST /v1/enrichment/addressAddress enrichment
enrich_latlngPOST /v1/enrichment/latlngLat/lng enrichment
enrich_apnPOST /v1/enrichment/apnAPN enrichment

​
Common Workflows

​
Searching by Text

Use the query parameter to search across all your activity by filter name, location, enrichment input, or anything else in the original request. This is the fastest way to find a past search when you remember what you searched for but not when. 
{
  "query": "equity",
  "sort": [{ "field": "relevance", "direction": "desc" }]
}
This returns every activity that mentions “equity” anywhere in its request parameters — like searches using the equity_percent filter. The response includes a matched_on array showing exactly which part matched. See Text Search for the full reference.

​
Reviewing Past Searches

Pull up everything you’ve searched in the last 30 days: 
{
  "types": ["search_people", "search_properties"],
  "date_range": {
    "start": "2025-06-01T00:00:00Z",
    "end": "2025-06-30T23:59:59Z"
  },
  "sort": [{ "field": "created_at", "direction": "desc" }]
}

​
Checking If You’ve Already Accessed an Entity

Before running a new search or enrichment, check if you’ve already pulled data on a specific person or property: 
{
  "entity_ids": ["per_x1y2z3"],
  "types": ["search_people", "enrich_email", "enrich_phone"]
}
If results come back, you’ve already accessed that entity — and it won’t cost additional credits within the same billing period. Found an activity record for a search you want to re-run? The Get Activity endpoint returns the full original request parameters, so you can copy them directly into a new search request.

​
Building a Local Cache

Use activity history to maintain a local record of which entities you’ve already pulled. Page through the entity_ids on each activity to build a local lookup table, then skip entities you already have when running new searches.

​
Activity Endpoints

EndpointMethodDescription
/v1/activity/searchPOSTQuery and filter your activity history
/v1/activity/:activity_idGETGet full details of a specific activity record

​
Notes

  • Activity records are read-only. You cannot modify or delete them.
  • Activity is scoped to your organization — all API keys and OAuth tokens under the same organization share the same activity log.
  • Count queries (count_people, count_properties) are logged but do not include entity IDs since no data is returned.
  • Activity records are retained for 12 months from the date of the request.
  • Querying activity does not consume credits.

Search Activity

Query and filter your activity history.

Get Activity

Get full details of a specific activity record.

Searching

How to run searches that generate activity.

Credits

How credits work and how activity tracking helps avoid duplicates.