# Ringkasan Lookup

Lookup menjawab pertanyaan tentang penerima sebelum Anda mengirim pesan. Berikan nomor telepon dan Lookup memberi tahu jaringan yang melayaninya, negara, apakah nomor tersebut pernah pindah jaringan, dan jenis salurannya. Berikan alamat email dan Lookup memberi tahu apakah alamat tersebut layak untuk dikirim.

Keduanya satu permintaan dan satu jawaban. Tidak ada yang perlu dibuat, tidak ada yang perlu di-poll, dan tidak ada yang perlu dibersihkan setelahnya. Halaman [**Lookup**](https://bird.com/dashboard/w/lookup) di dashboard menjalankan dua operasi yang sama satu per satu, dan ini cara tercepat untuk melihat seperti apa jawaban yang dihasilkan sebelum Anda menulis kode apa pun.

## Biaya setiap lookup

Setiap lookup dibebankan ke wallet organisasi Anda, dan ini bagian yang perlu dipahami sebelum Anda membangun di atasnya.

Lookup nomor telepon selalu menagih satu kali untuk base lookup. Di atasnya, Anda dapat meminta **properti**, fakta tambahan yang berasal dari sumber data berbayar. Setiap properti yang Anda minta ditagih terpisah, tetapi **hanya jika berhasil dikirim**. Properti yang tidak bisa dijawab dikembalikan dengan status yang menyatakan demikian dan tidak dikenakan biaya.

Lookup alamat email menagih satu kali per alamat yang dijawab. Setiap verdik ditagih, termasuk `undeliverable`: itulah jawaban yang Anda minta, dan itulah yang menyelamatkan Anda dari bounce.

Tidak ada yang ditagih jika lookup gagal. Nomor tidak valid, alamat yang kami tolak, atau sumber data yang tidak dapat dijangkau semuanya tanpa biaya.

[Harga Lookup](/products/lookup/pricing) mencantumkan tarif untuk base lookup, untuk setiap properti, dan untuk lookup alamat email.

## Lookup nomor memiliki dua tingkat

Pembagian ini adalah inti desain lookup nomor telepon, jadi perlu dijelaskan secara eksplisit.

**Base lookup** selalu dijalankan. Ia menjawab jaringan yang melayani, jaringan yang menerbitkan nomor, negara, apakah nomor tersebut pernah pindah jaringan, dan `line_type` kasar (mobile, fixed line, VoIP, toll-free, dan sebagainya). Jika base lookup tidak bisa dijawab, seluruh permintaan gagal alih-alih mengembalikan jawaban setengah kosong yang harus Anda periksa untuk mengetahui bahwa isinya kosong.

**Properti** adalah yang Anda tambahkan di atasnya, dengan menyebutkan namanya di `type`. Properti menjawab pertanyaan lebih detail: layanan teralokasi yang tepat dari rentang tersebut, catatan porting lengkap, apakah nomor saat ini aktif di jaringan, apakah sedang roaming, kapan SIM terakhir diganti, dan skor kredibilitas. Properti yang tidak bisa dijawab tidak pernah menggagalkan permintaan. Ia turun ke status, dan base lookup tetap disajikan.

## Hanya `ok` yang membawa nilai, dan hanya `ok` yang ditagih

Setiap blok properti memiliki `status`, dan membacanya bukan opsional.

`ok` berarti properti dijawab, nilainya ada di respons, dan ditagih.

`unavailable` berarti tidak ada jawaban yang diterima, jadi properti tidak menambahkan apa pun. Tidak ditagih.

`inconclusive` berarti jawaban diterima tetapi tidak menyelesaikan properti: nomor berada di luar cakupan data di belakangnya, atau sumber mengembalikan nilai yang tidak dilaporkan oleh properti ini. Ini adalah temuan nyata, bukan data yang hilang, dan juga tidak ditagih.

`status` adalah kosakata terbuka, jadi nilai baru dapat ditambahkan. Percabangan berdasarkan `ok` dan perlakukan yang lain sebagai "not answered" agar kode Anda tetap benar seiring perkembangannya.

## Memilih antara Lookup dan validasi saat pengiriman

Lookup digunakan untuk memutuskan **sebelum** Anda berkomitmen, satu penerima pada satu waktu: memeriksa nomor atau alamat saat pendaftaran, menyaring lead sebelum Anda menindaklanjutinya, atau merutekan pesan secara berbeda tergantung jenis salurannya. Biayanya per pemeriksaan dan memberikan jawaban yang bisa Anda tindaklanjuti.

Jika Anda hanya ingin berhenti mengirim ke alamat yang sudah bounce atau mengajukan keluhan, Anda tidak perlu Lookup. [Suppressions](/docs/guides/email/suppressions) melakukannya secara otomatis dan gratis.

Tidak ada operasi yang memiliki bentuk batch, dan [pembatasan laju permintaan](/docs/guides/rate-limits) `lookup` dimulai dari 10 permintaan per menit per kredensial, jadi memeriksa seluruh daftar bukan yang dirancang untuk saat ini. Hubungi kami untuk menaikkan batas jika Anda membutuhkannya.

## Langkah selanjutnya

- [Lookup nomor telepon](/docs/guides/lookup/phone-numbers) membahas base lookup, setiap properti, dan apa yang dikembalikan masing-masing.
- [Lookup alamat email](/docs/guides/lookup/email-addresses) membahas verdik dan tindakan yang perlu dilakukan untuk masing-masing.
- [Referensi API Lookup](/docs/api/reference/create-phone-number-lookup) mendokumentasikan setiap field.
- [Idempotency](/docs/guides/idempotency) menjelaskan cara mencoba lagi lookup tanpa membayar dua kali.

## Related resources

- [Phone number lookup: check a number before you send](/learn/lookup/phone-number-lookup-check-a-number-before-you-send) (video)
- [Lookup](/lookup-api) (product)

[Get an implementation brief](/learn/workspace?topic=lookup)