Questions & answers
Verify FAQs.
Get answers about delivering verification codes and checking them securely in your sign-in flow.
Built with BirdCustomer stories
Customer storiesBuilt with Bird
Trusted by engineering and product teams shipping at global scale.
Frequently asked questionsExplained
ExplainedFrequently asked questions
Verify FAQ
How do I add verification to my app?
Integration takes two API calls: one to send a code to the user's phone number or email address, and a second to check the code they submit. Because Bird matches the check against the recipient address and your verification configuration, you do not need to store a session ID between requests.
Which channels can I verify over?
You can verify users over SMS, WhatsApp, and email today, with voice rolling out as an additional channel. You can adjust enabled channels, fallback order, and sender identities per country without deploying code changes.
Do I have to store a verification id?
No. Resending a code uses the same send request, and code checks match against the recipient's phone number or email address, so your backend does not need to track per-request verification state. The API still returns an identifier in case you want to inspect delivery status later.
Who do my users see the code from?
You can choose between two Bird-managed sender identities per channel: Bird Verify by default, or Authifly when you prefer a neutral brand that does not display a platform vendor to your users. For email, you can also send from your own verified domain. WhatsApp messages come from the chosen identity's verified business profile, and SMS uses a branded sender ID where local regulations permit one or a local number or short code where required. Authifly is operated by Bird B.V. and provides a public verification page explaining that it delivers legitimate one-time passcodes on a business's behalf.
How much does it cost?
Verify pricing is tailored to your destination countries, channels, and message volume while public self-serve rates are being finalized. Contact our sales team to get a quote for your verification traffic.
Do I pay extra for using Verify?
No. Bird does not charge a separate Verify platform fee or per-verification surcharge. You pay the standard delivery rate for the channel that sends each code.
What does checking a code cost?
Code checks are free of charge. Billing applies when Bird sends a verification message, and checking a submitted code carries no fee whether the check succeeds or fails.
If a send falls back to a second channel, do I pay twice?
Yes. Because Bird dispatches two separate messages, the initial attempt and the fallback delivery are each billed at their respective channel rate. Requesting a resend on the same channel is billed the same way.
How long is the code, and how long does it last?
By default, Bird issues a six-digit numeric code valid for ten minutes. You can configure the length from four to eight numeric digits and set the validity window up to roughly 16 hours to match your security requirements.
What happens when someone enters the wrong code?
The check response tells your app whether the code matched and why a check failed. It distinguishes between a mistyped code with remaining attempts, a session that ran out of attempts, and a code whose time window passed, so your app can prompt another try or offer a new code.
How many guesses does a user get?
Users get five attempts by default, configurable between one and ten tries. Once those attempts are used up, the code is invalidated and the user must request a fresh verification.
How often can I resend a code to the same person?
Bird enforces a cooldown between sends to the same recipient, set to 60 seconds by default and configurable up to an hour, along with an hourly per-recipient send limit. Together, these limits cap what abuse or automated traffic pumping can cost your account.
What is SMS OTP?
An SMS one-time passcode is a short numeric code texted to a user's phone number that they enter in your app to confirm ownership of that number. Because mobile phones receive text messages out of the box without installing an extra app, SMS works well for signups and two-factor logins.
Which countries can I reach?
Bird delivers SMS codes across international destinations using pre-configured Bird Verify or Authifly senders. Depending on local telecom regulations, messages arrive from a branded alphanumeric sender ID, a local phone number, or a short code, with support for dedicated registered senders expanding coverage further.
How do you stop SMS pumping and brute force?
Bird enforces per-recipient cooldowns, hourly send caps, and per-code attempt limits out of the box to block brute-force guessing and cap repeat-send abuse. Additional automated fraud signals and carrier-level traffic pumping controls are on the roadmap.
When should I verify by email instead of SMS?
Email reaches users without requiring a phone number. That makes it a strong default for signups and account recovery, or a practical fallback when a phone number is unavailable. Many products offer both email and phone verification so users can pick the channel they have on hand.
Can I send from my own domain?
Yes. Codes send from a Bird-managed shared domain by default under either the Bird Verify or Authifly sender identity. You can also connect a domain you have verified with Bird so verification emails arrive from your own address.
Do you check the suppression list before sending an OTP?
One-time passcodes are transactional security messages, so marketing unsubscribes do not block them. Users who opted out of promotional campaigns still receive their login and signup codes.
Is WhatsApp verification available today?
Yes. WhatsApp is available alongside SMS and email as a built-in channel in your country routing plan and uses the same send and check API calls.
Why verify over WhatsApp instead of SMS?
WhatsApp delivers codes through verified, branded authentication templates inside an app many users keep open over Wi-Fi or mobile data. In regions where WhatsApp is the primary messaging app, placing it ahead of SMS improves delivery speed and user trust while keeping SMS ready as a backup.
What happens if the user isn't on WhatsApp?
When you verify a phone number, your country plan can queue SMS behind WhatsApp. If WhatsApp cannot deliver the code, the verification session can fall back to SMS on the same phone number, and codes sent during that active session remain valid until the user verifies, the time window ends, or attempts run out.
Is voice verification available today?
Voice verification is rolling out alongside SMS, WhatsApp, and email. It plugs directly into your country routing plan as an orderable phone channel, so enabling spoken passcodes requires no changes to your send or check API calls.
When should I use voice OTP?
Spoken one-time codes reach landlines, areas with delayed SMS delivery, and users who prefer an audio call over reading a text message on screen. Many teams configure voice as an automatic backup when an initial SMS or WhatsApp code goes undelivered.
How does voice fit with SMS?
Both channels use the same recipient phone number. When you place SMS first and voice second in your country routing plan, a verification session can step from a text message to a phone call while previously issued codes in that active session remain valid.
Which channel should I use for the second factor?
Start with the contact detail your user has already verified: phone numbers can receive codes over SMS, WhatsApp, or voice, while email addresses verify through the inbox. Bird's country routing lets you prioritize the highest-converting phone channel in each market.
Does adding 2FA mean storing verification state?
No. Your sign-in handler requests a code for the user's phone number or email address and submits their entered code against that same recipient address. Bird tracks the active code, validity window, and remaining attempts, so you do not need a pending-verification table in your database.
How is passwordless different from 2FA?
Two-factor authentication pairs a one-time code with a password, whereas passwordless sign-in replaces the password with a one-time code sent to the user's phone or inbox. Both flows use the same Bird Verify send-and-check calls, so the difference is whether your app prompts for a password first.
Is passwordless less secure without a password?
Removing passwords eliminates a frequent target for credential stuffing, phishing, and reuse across sites. Bird generates each one-time code cryptographically, stores it as a hash, and protects it with attempt limits and send caps so sign-in depends on controlling the receiving phone number or inbox.
Can users log in without typing a code?
Silent mobile network verification is designed to confirm a phone number directly with the carrier without asking the user to type a code. Bird Verify models silent authentication as a channel within the same verification flow, so you can adopt it as coverage rolls out without rebuilding your sign-in logic.
How does a verification resolve to a channel plan?
When you start a verification, Bird combines its country-level routing defaults with any per-request overrides you pass, such as preferred channels or digit length. The resulting plan filters out channels unavailable in that destination and returns the active delivery order in the API response.
What does Bird's per-country base give me?
You get working country routing out of the box without researching local telecom rules yourself. Bird maintains the recommended channel order, compliant sender types, and sensible code settings per market based on live delivery performance across email and SMS.
Can I enable a channel Bird doesn't offer in a country?
No. Country availability sets the upper bound on which channels can run in a given market. If a configuration includes a channel that Bird does not offer in that country, Bird skips it during plan resolution so your verification flow routes through supported channels.
How is the country determined?
Bird detects the destination country automatically from the international dialing prefix on the recipient's phone number and applies the matching country route. You do not need to pass a separate country parameter, and email verification runs independently of country rules.
How are the codes generated and stored?
Bird generates each code using a cryptographic random number generator, stores a keyed cryptographic hash instead of the raw digits, and compares submissions in constant time. The plaintext code is omitted from API responses and excluded from internal logs.
How do you stop someone brute-forcing the code?
Each verification allows a fixed number of check attempts, set to five by default, and evaluates guesses in constant time to prevent timing side-channel leaks. Once those attempts are used up, Bird invalidates the code so automated guessing cannot succeed.
Do these protections cost extra?
No. Cryptographic code generation, hashed storage, constant-time verification checks, attempt lockouts, and send rate limits are included by default without a separate security add-on.
Where is my data stored?
Verification data stays in the US or EU hosting region configured for your Bird organization. Because your API key encodes that regional assignment, Bird SDKs and the CLI route requests to your region's endpoint automatically without manual URL setup.
What can an API key actually do?
An API key is limited to the specific read or write permissions you assign it, so a key created for verification requests does not need access to other workspace resources. You can also restrict a key to approved IP address ranges and rotate keys with a configurable grace period, set to 24 hours by default, to avoid deployment downtime.
Where do I get your security and data-protection paperwork?
You can review compliance certifications and security documentation in the Bird Trust Center at trust.bird.com, and find the data processing agreement, privacy statement, and acceptable use policy at bird.com/legal. If your procurement process requires a custom security questionnaire, your Bird account team can complete it with you.
Verify users across SMS, WhatsApp, and email.
Talk with our team about country coverage, sender identities, fallback routing, and volume pricing for your signup and login flows.
Your next ideaStart building
Start buildingYour next idea