---
title: "Changes to Submit a Local Leads Search"
method: POST
path: "/bulk/local-leads"
---

# Changes to Submit a Local Leads Search

`POST /bulk/local-leads`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 18 revisions.

- **2026-09-27** `00d5d8987aba`: 2 breaking, 16 warning, 8 info
- **2026-08-25** `1f289eff3a26`: 3 breaking
- **2026-08-05** `08b59585eeb7`: 2 breaking, 3 info
- **2026-07-26** `f01f73557a67`: 1 info

## Changes

- **2026-09-27** `00d5d8987aba`: 2 breaking, 16 warning, 8 info
  - removed the required property `queue` from the response with the `202` status
  - removed the required property `totalRows` from the response with the `202` status
  - removed the optional property `downloadUrl` from the response with the `202` status
  - removed the optional property `endpoint` from the response with the `202` status
  - removed the optional property `errorsUrl` from the response with the `202` status
  - removed the optional property `eventsExportUrl` from the response with the `202` status
  - removed the optional property `eventsUrl` from the response with the `202` status
  - removed the optional property `exp` from the response with the `202` status
  - removed the optional property `logsUrl` from the response with the `202` status
  - removed the optional property `progressUrl` from the response with the `202` status
  - removed the optional property `resultsUrl` from the response with the `202` status
  - removed the optional property `rowsUrl` from the response with the `202` status
  - removed the optional property `statusUrl` from the response with the `202` status
  - removed the optional property `streamUrl` from the response with the `202` status
  - removed the optional property `token` from the response with the `202` status
  - removed the optional property `wsUrl` from the response with the `202` status
  - added the new `processing` enum value to the `status` response property for the response status `202`
  - added the new `queued` enum value to the `status` response property for the response status `202`
  - added the new optional request property `dryRun`
  - added the non-success response with the status `402`
  - added the non-success response with the status `429`
  - added the optional property `position` to the response with the `202` status
  - added the required property `creditsCharged` to the response with the `202` status
  - added the required property `locations` to the response with the `202` status
  - added the required property `totalSearches` to the response with the `202` status
  - added the success response with the status `200`
- **2026-08-25** `1f289eff3a26`: 3 breaking
  - the `allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property format changed from `uri` to `uri-reference` for status `400`
  - the `oneOf[#/components/schemas/InvalidApiKeyError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property format changed from `uri` to `uri-reference` for status `401`
  - the `oneOf[#/components/schemas/MissingAuthenticationError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property format changed from `uri` to `uri-reference` for status `401`
- **2026-08-05** `08b59585eeb7`: 2 breaking, 3 info
  - added the new required request property `cities`
  - added the new required request property `keywords`
  - added the new optional request property `countryCodes`
  - added the new optional request property `fileName`
  - added the new optional request property `magicKey`
- **2026-07-26** `f01f73557a67`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/leadmagic/apis/leadmagic-api/docs/bulk/local-leads/post.md) - [API](https://skmtc.dev/leadmagic/apis/leadmagic-api.md) - [Page](https://skmtc.dev/leadmagic/apis/leadmagic-api/changes/bulk/local-leads/post)