Where do I start?
Run an example in the Docs to see a response before signing up. When you're ready to integrate, get a key from your dashboard and copy an example in your language.
FAQ
Getting started
What is included on Free?
A monthly pool of API requests, plus included allowances for metered checks. Current allowances are on Plans, with remaining usage in your dashboard.
Can I use ParseAPI without writing code?
Yes. Upload a file to Bulk, choose what to check, review the sample and price, then run the file. Download your original rows with the results added as new columns.
Can I choose the language of Bulk results?
Yes. In Columns and formats, choose Output language from 33 languages and apply it to preview the result. Names change, such as Germany to Allemagne in French. Original values, headers and codes stay unchanged; missing translations keep their source label. The choice stays with the file and can be reused through "another file like this". Plan jobs use the team's default API version; display languages require the current contract. Choose Original labels for the default output.
Does ParseAPI work outside the US?
Yes. Coverage depends on the lookup, and available fields can vary by country. Choose an API to see its coverage and try your input. The docs explain what each field means, including when an answer can be null.
How fast is ParseAPI?
See Status for current regional and endpoint measurements. The headline measures selected parsing and reference lookups. Checks that contact a live network, such as email verification, can take longer.
Can I use ParseAPI across projects or with a team?
Create named keys for separate projects, apps, or environments. Keys on one team share its plan and allowances. Free is solo. Paid plans include team seats, with invites in Settings and seat counts on Plans.
Billing
What happens if I exceed my monthly requests?
Free requests stop when the monthly allowance is used up. Upgrade to a paid plan with enough capacity or wait for the next UTC monthly reset. Paid plans on current terms include seven days of grace after the allowance is exceeded, ending sooner if the month resets. There are no automatic request overage charges. Existing teams keep their previous request policy until they switch plans. Metered checks have separate limits. See your Plan for your current terms.
Which checks have a separate allowance?
Mailbox verification uses POST /email/verify. Carrier, caller name, and HLR have their own metered endpoints. Each has a monthly allowance, including on Free. Requests also count toward the pooled request total. See Plans for included amounts and on-demand rates.
What happens when a metered allowance runs out?
Further metered checks stop unless on-demand usage is enabled on an eligible plan. Set that in Plan, along with an optional monthly spend cap shared across metered products. Core email validation and phone parsing continue while your monthly request allowance or paid-plan grace period permits.
Do I need a subscription to run a file?
No. Walk-in and Free-plan Bulk jobs are priced per file in USD, with the price shown before payment. A one-time payment does not start a subscription. Jobs on a paid team use that plan's allowances and on-demand settings.
Can I cancel my subscription?
Yes, from Plan in your dashboard. Cancellation stops the next renewal. You keep paid access through the end of the period you already paid for.
How do refunds work?
Subscription fees are generally non-refundable except where required by law or agreed in writing. Completed one-time Bulk jobs retain the order minimum shown before payment. Unknown results can refund only the amount paid above it, with automatic partial refunds from $1 per file. Failed jobs receive a full refund. See the billing terms.
What if I need higher volume or a custom agreement?
For higher volume, SSO, contracts, or invoice billing, contact Email about a Custom plan.
Integration
What does ?deep=true do?
On API 2.1, paid plans include profile fields automatically. Where supported, deep=false selects the smaller response;deep=true explicitly requests detail your account can access. Existing accounts keep their current profile access. Fields appear at their natural homes in the response. Mailbox verification is a separate POST /email/verify request. Carrier and HLR return their complete selected result without a deep switch. See the response guide for access and examples.
Can I call ParseAPI from the browser?
Yes. Create a public key (parse_public_) and set its allowed domains in the dashboard. Add localhost for local development. Keep secret keys (parse_) on your server. See key types for setup and restrictions.
Can I use ParseAPI in a native mobile app?
Yes. Use an app key with your allowed app IDs and an app SDK. App keys support lookups and plan-included deep data. They cannot call metered endpoints, including POST /email/verify. Keep live verification on your server. See key types.
Why am I getting a 429?
Check the error code. rate_limited means the per-minute limit was reached. Wait for the Retry-After interval before trying again.quota_exceeded means a monthly request allowance, metered allowance or spend cap needs attention. The error guide explains what to do next.
Can AI agents use ParseAPI?
Yes. Connect a supported AI tool through MCP to run lookups from a conversation. Calls use the same plan allowances and metered rates as the API. For an agent writing an integration, start with the resources on Agents.
Trust
Is my data private?
We don't sell your personal data or your query stream as a marketing product. Read Privacy for what we collect, how we use it, and how long it is retained.Security covers account and API protections.
What if the API goes down?
Check Status for service availability. We target 99.9% monthly uptime for the paid service. Eligible paid customers can request service credits under the SLA. Free is best-effort.
How do I get help?
Email Email. We answer first come, first served, regardless of plan. For an API issue, include the endpoint, error message, and request ID when available. Leave your secret key out.