> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bettercontact API Guide for GTM Workflows

> Launch BetterContact enrichment jobs, then fetch terminal results with the result endpoint. Includes inputs, outputs, costs, and Deepline CLI examples.

## Playbook

# BetterContact Agent Guidance

## Key patterns

* **Enrichment is async.** `bettercontact_enrich` and `bettercontact_bulk_enrich` launch BetterContact jobs and return a request id immediately. Use `bettercontact_get_result` to fetch terminal results.
* **Email status hierarchy:** deliverable > catch\_all\_safe > catch\_all\_not\_safe > undeliverable. Only trust deliverable and catch\_all\_safe for outreach.
* **Batch up to 100 contacts** per enrichment request using `bettercontact_bulk_enrich`.
* Use the launcher response `id` as the `request_id` for `bettercontact_get_result`.
* **Rate limit:** 600 requests per minute per API key, shared across all endpoints. This is BetterContact's confirmed going-forward limit; its public rate-limit page still shows the previous 60 RPM value.

## Pricing

* 1 successful email = 1 provider credit, 1 successful mobile phone = +10 provider credits
* `bettercontact_get_result` returns `credits_consumed`; Deepline bills from that terminal provider usage
* **Phone enrichment is expensive** — only enable `enrich_phone_number: true` when explicitly needed

## When to use

* Use BetterContact when you need waterfall email enrichment with multi-provider verification.
* Good fallback when single-provider finders (LeadMagic, Prospeo) miss.
* Includes triple email verification, phone verification, contact & company enrichment.

## When NOT to use

* Don't use for email validation only — use a dedicated validator.
* Don't use for company/org enrichment — BetterContact is contact-focused.