Catalog

Get pricing

Read the price card: what each lead and each filter costs, in credits.

GETapi.leadity.io/v1/pricing

Scope readMCP tool get_pricing

Answers every rate Leadity charges, in credits. A new lead costs lead times its niche's multiplier, plus the rate of every filter the order turns on. For the price of one particular order, call estimate_scrape instead: it applies the account's own floors and answers the exact per-lead rate.

Example request

curl "https://api.leadity.io/v1/pricing" \
  -H "Authorization: Bearer $LEADITY_API_KEY"

Example response

{
  "version": "9c41d07a2e5b",
  "lead": 0.2,
  "phoneTypeFilter": 0.8,
  "phoneWithPhone": 0.05,
  "findOwner": 2.5,
  "nicheMatch": 0.5,
  "minGoogleReviews": [
    {
      "reviews": 1,
      "credits": 0.05
    },
    {
      "reviews": 1000,
      "credits": 8
    }
  ],
  "website": {
    "any": 0,
    "has": 0.5,
    "none": 1
  },
  "review": 0.02,
  "reviewsMax": 1000,
  "emailRequire": 0.8,
  "emailRequireVerify": 1.3,
  "enrichMinNames": 10,
  "validation": {
    "phone": 0.2,
    "email": 0.2,
    "maxItems": 50000
  }
}

Headers

Authorizationstringrequired

Bearer, a space, then an API key: Bearer lk_api_... An MCP key is refused here with wrong_key_kind.

Response

versionstringrequired

The price card's content version. It changes whenever any rate moves.

leadnumberrequired

Credits for one new lead at a niche multiplier of 1, before any filter.

phoneTypeFilternumberrequired

Added per lead when phoneTypeFilter is mobile, landline or voip.

phoneWithPhonenumberrequired

Added per lead when phoneTypeFilter is with_phone.

findOwnernumberrequired

Added per lead by the owner-name lookup, and the price of one confirmed name from purchase_owner_names.

nicheMatchnumberrequired

Added per lead by the niche match.

minGoogleReviewsobject[]required

Every orderable minGoogleReviews floor, cheapest first.

Show child attributes

reviewsintegerrequired

The floor: deliver only businesses showing at least this many Google reviews.

creditsnumberrequired

What that floor adds per lead.

websiteobjectrequired

Added per lead by each websitePresence value.

Show child attributes

anynumberrequired

hasnumberrequired

nonenumberrequired

reviewnumberrequired

Credits per Google review walked by review scraping.

reviewsMaxintegerrequired

The most reviews review scraping walks per business.

emailRequirenumberrequired

Added per lead when emailFinder is require.

emailRequireVerifynumberrequired

Added per lead when emailFinder is require_verified.

enrichMinNamesintegerrequired

The smallest targetNames purchase_owner_names takes on a large pool.

validationobjectrequired

Standalone validation, the customer's own list.

Show child attributes

phonenumberrequired

Credits per phone number answered.

emailnumberrequired

Credits per address answered.

maxItemsintegerrequired

The most items one validation run takes.

Errors

Every refusal answers { error, message } with the status below. The full list is on the Errors page.

Code	Status	Meaning	Extra fields
unauthorized	401	The API key is missing, malformed, revoked or expired.	-
wrong_key_kind	401	This key opens the other surface: an API key works on the HTTP API, an MCP key on the MCP server.	-
account_suspended	403	The account is suspended.	-
email_not_verified	403	The account's email address is not verified yet.	-
rate_limited	429	Too many requests. Wait for the Retry-After seconds and try again.	`retryAfterSeconds`: The seconds to wait, the same number as the Retry-After header.
try_again	503	Leadity could not answer just now. Retry in a moment, with the same Idempotency-Key on a spending call.	`retryAfterSeconds`: When a request with this Idempotency-Key is still being processed: the seconds to wait before retrying with the same key, as the Retry-After header says.
internal_error	500	Something failed on our side. Nothing was charged twice.	`body`: On the MCP server, when Leadity answered in a shape the tool does not publish: that answer as it came.