Tanya & jawab
Pertanyaan seputar Lookup, terjawab.
Cari tahu pemeriksaan mana yang sesuai untuk kontak yang perlu Anda verifikasi.
Dibangun dengan BirdKisah pelanggan
Kisah pelangganDibangun dengan Bird
Dipercaya oleh tim engineering dan produk yang merilis produk dalam skala global.
Pertanyaan yang sering diajukanPenjelasan
PenjelasanPertanyaan yang sering diajukan
FAQ Lookup API
Apa itu Bird Lookup?
Bird Lookup verifies phone numbers and email addresses before you send a message or accept a signup. For a phone number, it returns the country, serving and issuing carriers, porting status, line type, and optional network checks. For an email address, it returns a deliverability verdict, confidence score, inbox type flags, and suggested typo corrections.
Apa yang bisa saya cari?
You can check phone numbers and email addresses through dedicated endpoints. A phone number lookup returns the country, serving carrier, original issuing carrier, porting status, and line type, along with any optional enrichment properties you request. An email address lookup validates a single address or a synchronous batch and returns a deliverability verdict, confidence score, and address classification flags.
Seberapa sulit integrasinya?
A lookup completes in a single synchronous request and response without webhook setup or polling. You can call the REST endpoints directly, use typed methods in the Go, TypeScript, Python, and PHP SDKs, or run phone number and email lookups from the terminal with the Bird CLI.
Bisakah saya menjalankan pencarian tanpa menulis kode?
Yes. You can check individual phone numbers and email addresses directly from the Lookup page in the Bird dashboard to inspect carrier details, enrichment properties, and deliverability verdicts before integrating the API.
Apa yang saya butuhkan sebelum pencarian pertama?
You need an API key with lookup write permission and a funded organization wallet. Lookups are billed per query without monthly seat fees or upfront plan commitments.
Kapan saya harus menggunakan Lookup alih-alih langsung mengirim?
Use Lookup when you want to verify contact details before spending on delivery or admitting an account. Common workflows include blocking disposable emails and virtual numbers at signup, screening lead lists before outreach, and routing OTPs to voice instead of SMS when a number is a landline.
Bagaimana harga Lookup?
Lookups are billed per query from your organization's wallet with no seat fees. A phone number lookup charges a base rate plus an individual fee for each requested enrichment property that returns an answer. An email address lookup charges per validated address.
Di mana saya dapat menemukan tarifnya?
The Lookup pricing page lists the per-query rate for a base phone number lookup, each optional enrichment property, and an email address lookup. Property rates vary because each check queries a distinct carrier or intelligence data source.
Apakah saya membayar untuk properti yang kembali kosong?
No. You are charged for an enrichment property when it returns a resolved answer. If a property is unavailable or inconclusive, its status explains why at no charge for that property, and you still receive the base phone number lookup.
Apa yang terjadi pada tagihan saya jika pencarian gagal?
Permintaan yang gagal tidak ditagih. Jika nomor telepon atau satu alamat email formatnya salah, atau sumber data hulu tidak dapat dijangkau, wallet Anda tidak dikenai biaya. Batch email mengembalikan penilaian untuk setiap alamat dan menagih masing-masing, termasuk alamat yang formatnya salah.
Apakah saya ditagih untuk alamat yang ternyata tidak dapat dikirim?
Yes. Validated email addresses are billed regardless of the deliverability verdict, including undeliverable addresses. Identifying an invalid mailbox upfront prevents a hard bounce and protects your sender reputation.
Bisakah percobaan ulang menagih saya dua kali?
Kirim Idempotency-Key bersama permintaan lookup POST. Percobaan ulang dengan kunci yang sama dan permintaan yang identik di workspace yang sama dalam tiga jam akan mengembalikan respons yang tersimpan tanpa menjalankan atau menagih lookup lain. Setelah tiga jam, atau jika tidak ada respons yang disimpan, misalnya untuk respons batch email yang lebih besar dari 256 KiB, percobaan ulang dapat menjalankan dan menagih lookup atau batch tersebut lagi. Bentuk GET, yang menempatkan nomor atau alamat di URL, tidak menerima kunci idempotensi, jadi gunakan endpoint POST untuk alur kerja otomatis.
Berapa banyak pencarian yang bisa saya jalankan per menit?
Hal ini bergantung pada batas laju Lookup organisasi Anda. Organisasi Anda berbagi batas tersebut di seluruh kunci API dan workspace-nya, sehingga membuat kunci baru tidak menambah kapasitas, dan satu batch email berisi hingga 1.000 alamat dihitung sebagai satu permintaan. Header batas laju pada respons Lookup menunjukkan batas yang berlaku untuk permintaan Anda. Karena setiap lookup mengakses sumber data operator atau domain eksternal dan ditagihkan ke wallet Anda, organisasi baru memulai dengan batas yang konservatif. Hubungi kami untuk menaikkannya seiring bertambahnya volume Anda, dan lihat panduan Rate limits di dokumentasi untuk cara membaca header tersebut.
Apakah ada pencarian batch atau massal?
Email address lookup supports synchronous batches of up to 1,000 addresses in a single request, with a maximum request body of 128 KiB. Phone number lookup checks one number per request, and you can contact us to raise your rate limit for higher-throughput phone verification.
Scope apa yang dibutuhkan pencarian?
Lookup endpoints require the lookup permission scope with write access. Because lookups trigger billable external queries and do not expose separate read-only endpoints, write permission is required across the API. Workspace owners and admins have this access by default.
Error apa saja yang bisa dikembalikan oleh pencarian?
Lookups return specific error responses when a phone number is missing a valid international country code, when an email address is malformed, when your organization's wallet has insufficient balance to cover the query, or when an upstream lookup service is temporarily unavailable. Failed requests do not charge your wallet.
Apakah properti yang tidak dapat dijawab membuat permintaan saya gagal?
No. When an optional enrichment property cannot be resolved, it returns an unavailable or inconclusive status on its own section of the response while the base phone number lookup still succeeds. A request fails outright when the base lookup itself cannot be completed.
Apa yang dijawab oleh pencarian nomor telepon?
A base phone number lookup returns the number's country, its current serving carrier, the carrier that originally issued the number range, whether the number has been ported between carriers, and its general line type. If the base lookup cannot be resolved, the request returns an error rather than an incomplete response.
Bagaimana cara menulis nomornya?
Format the number in international E.164 order with the country calling code followed by the national number. You can include a leading plus sign, omit it, or use a 00 international prefix, so +31612345678, 31612345678, and 0031612345678 resolve to the same Dutch mobile number.
Mengapa nomor saya ditolak?
Numbers written in local national format without a country calling code are rejected instead of guessed. Automatically prepending a country code to a local string like 0612345678 could match an unrelated international number and bill your wallet for the wrong lookup.
Jenis saluran apa saja yang dapat dikembalikan?
The base lookup classifies numbers into mobile, landline, VoIP, toll-free, premium-rate, satellite, pager, payphone, machine-to-machine, service, other, or unknown line types. An unknown result means the carrier registry has no classification for that number range, while other indicates a specialized category outside the standard list. You can request the line classification property when you need finer detail on the allocated service.
Bagaimana cara mengetahui apakah nomor telah dipindahkan (ported)?
The base response includes both the serving carrier that routes the number today and the original carrier that was allocated the number block. When a subscriber moves their number to a new operator, those two carrier blocks differ and the response includes a ported indicator. Add the porting history property when you need the date of the most recent move and the full record of carrier transfers.
Why is the country code missing from my answer?
Some international numbering ranges, such as global satellite or non-geographic services, are not assigned to a single country. When a field has no applicable value, the response omits it rather than returning an empty placeholder, so each field present in the payload reflects a resolved value.
Apakah pencarian akan menelepon atau mengirim pesan ke nomor tersebut?
No. A lookup does not place a call or send a message to the recipient's device. Base lookups read carrier and numbering registries, and live checks such as network presence and roaming status query operator signaling networks silently without alerting the handset.
Properti apa saja yang dapat saya tambahkan ke pencarian nomor telepon?
You can request up to six optional enrichment properties on a phone number lookup: line classification for the precise service allocated to the number range, number porting history for the dates and carrier records of past network moves, live network presence to check whether the handset is currently reachable, active roaming status and the visited network, SIM swap recency to detect recent SIM card changes, and a credibility score from 0 to 100.
Apakah beberapa properti lebih lambat dari yang lain?
Yes. Line classification, number porting history, and the credibility score read indexed registry data and return with minimal latency. Live network presence, active roaming status, and SIM swap recency query the subscriber's mobile operator in real time, so they take longer to resolve and return unavailable or inconclusive statuses more frequently depending on carrier coverage.
Apa arti status properti?
Each requested property returns its own status. An answered status means the check succeeded, the property data is included in the response, and the property was billed. An unavailable status means the carrier or registry did not return data, at no charge. An inconclusive status means the upstream source responded without enough information to resolve the check definitively, which is also unbilled.
Bisakah status baru muncul di kemudian hari?
Yes. The status field uses an extensible set of values so new diagnostic states can be introduced without breaking existing integrations. Check for an answered status before reading the property data, and treat any other status as an unresolved check.
What do porting history and line classification add over the base answer?
While the base lookup indicates whether a number currently sits on a different carrier than the one that issued its range, the porting history property provides the timestamp of the latest transfer and the historical log of carrier moves. Line classification consults a more granular numbering registry to report the specific service allocated to the range alongside the base line type.
Why did the SIM swap check return a day range instead of an exact date?
Some mobile operators disclose SIM swap recency as a time window rather than an exact timestamp to meet regional privacy rules. When an operator reports a recency band, the response provides the minimum and maximum days since the last SIM change instead of a specific timestamp. Similarly, the porting history property flags when a national registry records the month or period of a carrier transfer rather than the exact calendar day.
Does an unported result mean the porting check failed?
No. When the porting history property reports that a number has not been ported, the national registry confirmed that the number still resides with its original issuing carrier. Check the property status field to see whether the registry query itself succeeded or was unavailable.
Bagaimana cara membaca skor tersebut?
Treat the credibility score as one risk signal alongside line type, porting history, and SIM swap recency. The score ranges from 0 for low credibility to 100 for high credibility based on composite numbering intelligence that goes beyond the other individual properties, so it works best when combined with your own application rules.
Apa yang dijawab oleh pencarian alamat email?
An email address lookup tells you whether a mailbox is ready to receive mail before you send to it. One request returns a deliverability verdict, a delivery confidence score from 0 to 100, classification flags for role, disposable, and free consumer inboxes, and a suggested typo correction when the domain looks misspelled.
Apa saja lima putusan tersebut?
A valid verdict means the mailbox exists and accepts mail. A neutral verdict means the receiving server accepts mail for the domain without confirming individual mailboxes, as catch-all domains do. A risky verdict means the address can receive mail but carries higher bounce or complaint risk, such as a disposable or role-based inbox. An undeliverable verdict means the address cannot receive mail, and a typo verdict flags a likely domain misspelling.
Mengapa sebuah alamat berstatus undeliverable?
When an address is marked undeliverable, the response specifies whether the failure comes from a syntax error in the address format, a non-existent or unconfigured mail domain, or an invalid mailbox that the receiving domain rejected.
Apa yang harus saya lakukan dengan putusan typo?
Present the suggested typo correction in your signup or checkout form so the user can confirm it before you send mail. Automatically rewriting an email address without confirmation risks sending sensitive account messages to the wrong person if the original address was intentional.
How does the delivery confidence score differ from the verdict?
The delivery confidence score scales from 0 for an address that will bounce to 100 for a verified, deliverable mailbox. Because different risk factors can produce similar numeric scores under different verdicts, use the verdict to choose the workflow action, such as prompting for a typo fix, and use the confidence score when you want a numeric threshold for list filtering.
How does basic format and domain validity differ from a valid verdict?
The boolean validity indicator checks whether the email address is syntactically well-formed and belongs to a domain configured to accept mail. It does not verify the individual mailbox, so an address at a working domain with a non-existent username passes basic domain validity while still receiving an undeliverable verdict.
Apa arti flag-flag tersebut?
Role addresses identify shared team inboxes such as support@ or info@, where individual consent is harder to track and complaint rates are higher. Disposable inbox providers issue short-lived throwaway addresses often used to bypass signup gates. Free consumer mail providers such as Gmail or Outlook.com help B2B forms distinguish personal addresses from company domains.
Bagaimana cara menulis alamat tersebut?
Pass the bare email address without a display name or angle brackets. Addresses wrapped in display-name headers are rejected so the API validates the exact string you store. Preserve the original casing of the local part before the @ symbol, since some mail servers treat local-part casing as significant when scoring deliverability.
Apakah saya perlu Lookup untuk berhenti mengirim ke alamat yang sudah bounce?
No. Bird's suppression list automatically blocks repeat sends to addresses that have already bounced or reported spam at no extra charge. Use Lookup to screen new email addresses before your first send, such as during account registration, checkout, or lead import.
Explore the Lookup API
See how phone number verification, email validation, and per-query pricing work across your signup and messaging flows.
- Pencarian nomor teleponIdentify the country, serving and issuing carriers, porting state, line type, and six optional network properties before you send an SMS or place a call.
- Pencarian alamat emailCheck deliverability verdicts, confidence scores, role and disposable inbox flags, and suggested typo corrections before sending email.
- HargaReview per-query rates for base phone number lookups, email validations, and optional enrichment properties that return an answer.
- Lookup APIValidate phone numbers and email addresses from one API to block fake signups, prevent bounces, and route messages by line type.
Verify recipients before you send a message.
Talk with our team about screening signups, choosing carrier and network checks for your risk model, or sizing throughput for high-volume verification.
Ide Anda berikutnyaMulai membangun
Mulai membangunIde Anda berikutnya