# UpLead > UpLead is a B2B contact and company data platform. Its v2 REST API returns verified > contact and company records: look up a person by email or by name plus company domain, > look up a company by domain or name, prospect for contacts by job function, management > level, industry and location, and manage saved contact lists. Billing is credit-based — > a credit is spent per record returned, and only when the record's email verification > comes back valid or accept-all. This file was generated by API Evangelist from the public UpLead developer surface. UpLead does not publish an llms.txt: https://www.uplead.com/llms.txt and https://docs.uplead.com/llms.txt both returned 404 on 2026-08-13. - Base URL: https://api.uplead.com/v2/ - Auth: API key sent bare in the `Authorization` header — `Authorization: myapikey`. No Bearer prefix. Required on every call. - Rate limit: 500 requests per minute per key. 429 on exhaustion, with `Retry-After` and `X-RateLimit-*` headers. - Response envelope: `{"data": ..., "userInfo": {"availableCredits": }}`. Errors: `{"error": {"type": ..., "message": ...}}`. - Pagination: `page` + `per_page` (max 100), with `data.meta` carrying total / page / next_page / previous_page / first_page / last_page. - Cost control: pass `count_only=true` on the prospector and quick-search endpoints for a free result count before spending credits. - Plan gating: Prospector Pro, Quick Search, Industries and Lists are Professional/Elite/Enterprise only; a 403 can mean plan, not key. ## Docs - [API documentation](https://docs.uplead.com/): the complete public reference — overview, authentication, errors, rate limits, email verification, billing, and every endpoint with parameters and attributes. - [API product page](https://www.uplead.com/data-api/): what the API is for, and the form to request an API key. - [Help Center](https://support.uplead.com/): account, lead management, and API + integrations guides. - [Release notes](https://support.uplead.com/en/collections/19646601-release-notes): dated product release notes, 2025-06-05 to 2026-08-10. - [Status page](https://status.uplead.com/): per-component uptime for api.uplead.com, with Atom and RSS incident feeds. - [Pricing](https://www.uplead.com/pricing/): credit allowances per plan; full API access is a Professional-plan feature. ## APIs - [Person API](https://docs.uplead.com/#person-api): `GET|POST /person-search` — a contact by email, or by first_name + last_name + domain, or by id. - [Company API](https://docs.uplead.com/#company-api): `GET|POST /company-search` — a company by domain, name, or id, with 30+ firmographic, classification and social attributes. - [Combined API](https://docs.uplead.com/#combined-api): `GET|POST /combined-search` — person and their full company object from one business email. - [Prospector API](https://docs.uplead.com/#prospector-api): `GET|POST /prospector-search` — contacts at a company filtered by job function, sub-function, management level, title and location. - [Prospector Pro API](https://docs.uplead.com/#prospector-pro-api): `GET|POST /prospector-pro-search` — the full filter set, including industries, SIC/NAICS codes, employee and revenue bands, regions and business types. - [Quick Search API](https://docs.uplead.com/#quick-search-api): `GET|POST /quick-search` — free-text search across contacts or companies. - [Company Name to Domain API](https://docs.uplead.com/#company-name-to-domain-api): `GET|POST /company-name-to-domain` — resolve a company name to its domain and logo. - [Company Logo API](https://docs.uplead.com/#company-logo-api): `GET https://logo.uplead.com/{domain}` — free logo lookup, attribution to uplead.com required. - [Industries API](https://docs.uplead.com/#industries-api): `GET|POST /industries` — the industry id vocabulary used by the Pro filters. - [Lists API](https://docs.uplead.com/#lists-api): `/lists` CRUD plus `/lists/{list_id}/contacts/add` and `/delete` for membership. - [Credits API](https://docs.uplead.com/#credits): `GET|POST /credits` — remaining credit balance. - [Preview API](https://docs.uplead.com/#preview-api): `GET|POST /prospector-preview` — reseller-only preview of prospector results. Documented by UpLead but not present in the OpenAPI definitions below. ## Specs These OpenAPI definitions were authored by API Evangelist from the public documentation. UpLead publishes no machine-readable specification of its own. - [Person API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-person-api-openapi.yml) - [Company API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-company-api-openapi.yml) - [Combined API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-combined-api-openapi.yml) - [Prospector API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-prospector-api-openapi.yml) - [Search API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-search-api-openapi.yml) - [Lists API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-lists-api-openapi.yml) - [Reference API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-reference-api-openapi.yml) - [Account API OpenAPI](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/openapi/uplead-account-api-openapi.yml) - [APIs.json](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/apis.yml) ## Artifacts - [Authentication](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/authentication/uplead-authentication.yml) - [Conventions](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/conventions/uplead-conventions.yml) - [Error catalog](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/errors/uplead-problem-types.yml) - [Data model](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/data-model/uplead-data-model.yml) - [Rate limits](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/rate-limits/uplead-rate-limits.yml) - [Plans and pricing](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/plans/uplead-plans-pricing.yml) - [Lifecycle](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/lifecycle/uplead-lifecycle.yml) - [Changelog](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/changelog/uplead-changelog.yml) - [Conformance](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/conformance/uplead-conformance.yml) - [Agent skills](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/skills/_index.yml) - [MCP candidate tool surface](https://raw.githubusercontent.com/api-evangelist/uplead/refs/heads/main/mcp/uplead-mcp.yml) ## Not published by UpLead Recorded so an agent does not go looking: no OpenAPI or Swagger on any host, no GraphQL, no gRPC, no webhooks or event stream, no AsyncAPI, no MCP server, no A2A agent card, no `/.well-known/` documents, no first-party SDK on any package registry, no CLI, no sandbox or test mode, and no deprecation policy.