# Overzicht van Lookup

Lookup beantwoordt vragen over een ontvanger voordat je naar diegene verzendt. Geef het een telefoonnummer en het vertelt je wat het nummer is: het bedienende netwerk, het land, of het van netwerk is gewisseld en wat voor soort lijn het is. Geef het een e-mailadres en het vertelt je of het adres het waard is om naartoe te sturen.

Beide zijn één verzoek en één antwoord. Er is niets om aan te maken, niets om te pollen en niets om achteraf op te ruimen. De [**Lookup**](https://bird.com/dashboard/w/lookup)-pagina in het dashboard voert dezelfde twee bewerkingen één voor één uit, en dat is de snelste manier om te zien hoe een antwoord eruitziet voordat je code schrijft.

## Wat elke lookup kost

Elke lookup wordt in rekening gebracht op de wallet van je organisatie, en dit is het deel dat je moet begrijpen voordat je erop bouwt.

Een telefoonnummer-lookup brengt altijd één keer de basislookup in rekening. Daarbovenop kun je **properties** opvragen, extra feiten uit een betaalde databron. Elke property die je opvraagt wordt apart in rekening gebracht, maar **alleen als die geleverd wordt**. Een property die niet beantwoord kon worden komt terug met een status die dat aangeeft en kost je niets.

Een e-mailadres-lookup brengt één keer per beantwoord adres in rekening. Elk oordeel wordt gefactureerd, `undeliverable` inbegrepen: dat is het antwoord waar je om vroeg, en het is het antwoord dat je een bounce bespaart.

Er wordt niets in rekening gebracht als een lookup mislukt. Een ongeldig nummer, een adres dat we weigeren of een databron die niet bereikbaar is kosten allemaal niets.

[Lookup-prijzen](/products/lookup/pricing) toont het tarief voor de basislookup, voor elke property en voor een e-mailadres-lookup.

## De nummerlookup heeft twee niveaus

Deze tweedeling is het hele ontwerp van de telefoonnummer-lookup, dus het is de moeite waard om hier duidelijk over te zijn.

De **basislookup** draait altijd. Die beantwoordt het bedienende netwerk, het netwerk dat het nummer heeft uitgegeven, het land, of het nummer ooit van netwerk is gewisseld en een globaal `line_type` (mobiel, vast, VoIP, gratis nummer, enzovoort). Als de basislookup niet beantwoord kan worden, mislukt het hele verzoek in plaats van een halfleeg antwoord terug te geven dat je zou moeten inspecteren om te ontdekken dat het leeg was.

**Properties** zijn wat je er bovenop toevoegt door ze op te geven in `type`. Ze beantwoorden fijnere vragen: de precieze toegewezen dienst van het bereik, het volledige porteringsrecord, of het nummer op dit moment actief is op het netwerk, of het aan het roamen is, wanneer de SIM voor het laatst is gewisseld en een betrouwbaarheidsscore. Een property die niet beantwoord kan worden laat het verzoek nooit mislukken. Die degradeert tot een status, en de basislookup wordt alsnog geleverd.

## Alleen `ok` bevat een waarde, en alleen `ok` wordt gefactureerd

Elk property-blok heeft een `status`, en die uitlezen is niet optioneel.

`ok` betekent dat de property beantwoord is, de waarde in het antwoord staat en gefactureerd is.

`unavailable` betekent dat er geen antwoord binnenkwam, dus de property voegt niets toe. Die is niet gefactureerd.

`inconclusive` betekent dat er een antwoord binnenkwam, maar dat het de property niet oplost: het nummer valt buiten de dekking van de achterliggende data, of de bron gaf een waarde terug die deze property niet rapporteert. Het is een echte bevinding in plaats van een ontbrekende, en het is evenmin gefactureerd.

`status` is een open vocabulaire, dus er kunnen meer waarden bijkomen. Branch op `ok` en behandel al het andere als "not answered", dan blijft je code correct ongeacht hoe het groeit.

## Kiezen tussen Lookup en valideren bij verzending

Lookup is bedoeld om **vooraf** te beslissen, één ontvanger tegelijk: een nummer of adres controleren bij aanmelding, een lead screenen voordat je erop handelt, of een bericht anders routeren op basis van wat de lijn blijkt te zijn. Het kost geld per controle en geeft je een antwoord waar je op kunt handelen.

Als je alleen wilt stoppen met verzenden naar adressen die al gebounced of geklaagd hebben, heb je Lookup niet nodig. [Suppressions](/docs/guides/email/suppressions) doen dat automatisch en gratis.

Geen van beide bewerkingen heeft een batchvorm, en de `lookup` [beperking van het aantal verzoeken](/docs/guides/rate-limits) begint op 10 verzoeken per minuut per credential. Een hele lijst controleren is dus niet waarvoor dit op dit moment geschikt is. Neem contact met ons op over het verhogen van de limiet als dat is wat je nodig hebt.

## Volgende stappen

- [Een telefoonnummer opzoeken](/docs/guides/lookup/phone-numbers) behandelt de basislookup, elke property en wat elk ervan teruggeeft.
- [Een e-mailadres opzoeken](/docs/guides/lookup/email-addresses) behandelt de oordelen en wat je met elk ervan doet.
- [Lookup API-referentie](/docs/api/reference/create-phone-number-lookup) documenteert elk veld.
- [Idempotentie](/docs/guides/idempotency) legt uit hoe je een lookup opnieuw kunt proberen zonder er twee keer voor te betalen.

## 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)