GeoLead Finder: Retrieve Info

Use this API endpoint to retrieve details and the current status of a previously created GeoLead search. It allows you to monitor progress or retrieve metadata about a specific search using the unique searchId.

Endpoint

GET

https://api.anymailfinder.com
/v5.1/geo-lead/{searchId}

Pricing

This endpoint is free to use.

Credits are only charged when you download the results for the first time.

Authentication

Include your API key using the Authorization header.
Refer to the Authentication page for setup instructions.

Code example

curl -X GET "https://api.anymailfinder.com/v5.1/geo-lead/{searchId}" \
  -H "Authorization: YOUR_API_KEY"

Request parameters

Path parameters

Parameter	Example value	Description
`searchId` string	`"blk_123a4b5c"`	The unique identifier of the GeoLead search.

Response

200OK

The request was successful. The response includes detailed information about the specified GeoLead search, including its status, counts, and associated metadata. Use this data to monitor the progress of the search or verify its completion.

{
  "counts": {
    "failed": 0,
    "found_unknown": 0,
    "found_valid": 0,
    "not_found": 0,
    "total": 0
  },
  "created_at": "2025-01-08T13:25:36.457Z",
  "credits_needed": 0,
  "file_name": "string",
  "find_company_emails": true,
  "find_decision_maker_categories": [
    "ceo"
  ],
  "id": "string",
  "latitude": 40.7127753,
  "longitude": -74.0059728,
  "paid": false,
  "query": "restaurants",
  "radius_km": 2,
  "result_limit": null,
  "started_running_at": "2025-09-15T13:50:42.000Z",
  "status": "completed"
}

Property	Type	Description
`status`	string	The current status of the GeoLead search. Possible values: `extraction_queued`: The search for companies matching the specified criteria is queued and will start soon. `extraction_running`: The search for companies is in progress. `queued`: The search for emails of the found companies is queued and will start soon. `running`: The search for emails of the found companies is in progress. `paused`: The GeoLead search has been temporarily paused. `completed`: The GeoLead search has finished successfully. `failed`: The GeoLead search processing failed due to an error.
`counts.failed`	integer	Number of rows where the search failed.
`counts.found_unknown`	integer	Number of rows with risky emails found.
`counts.found_valid`	integer	Number of rows with valid emails found.
`counts.not_found`	integer	Number of rows where no email was found.
`counts.total`	integer	Total number of rows in the search.
`created_at`	string	The datetime when the search was created.
`credits_needed`	integer	The maximum credits required to download the results. Duplicate searches within a month are not charged.
`file_name`	string	The label provided to identify this search.
`find_company_emails`	boolean	If company emails should be searched for the found companies.
`find_decision_maker_categories`	string[]	Which decision maker categories should be searched for the found companies.
`id`	string	Unique identifier for this GeoLead search.
`latitude`	number	The searched position latitude.
`longitude`	number	The searched position longitude.
`paid`	boolean	Indicates whether this search was paid for.
`query`	string	The searched type of companies (eg. "restaurants").
`radius_km`	integer	The searched position radius (in km).
`result_limit`	integer \| null	If a limit of result was set when the search was created.
`started_running_at`	string \| null	The datetime when the search started processing.

401Unauthorized

404Not Found

Need Help?

Our team is experienced with APIs and is here to help. Contact us via chat or email at team@anymailfinder.com.