---
updatedAt: 2026-06-17T16:34:00.000Z
agentTools:
  projectIndex: https://docs.rocketreach.co/llms.txt
---

# FAQ

## API Key & Access

**How do I create a RocketReach API key?**\
Go to **Account Settings** and click **“Generate New API Key.”**

***

## Tracking Usage & Rate Limits

**Can I track my team’s API usage?**\
Yes—use the `/v2/account` endpoint to view current usage.

**Can I track my team’s rate limits?**\
Yes—use the `/v2/account` endpoint. For full details, refer to our [Rate Limits Guide](rate-limits).

***

## Testing the API

**How can I test different endpoints?**\
Use the **“Try it”** feature in the API documentation to make live calls.

***

## What Can I Do with the API?

* **Find people & companies**: Use People and Company Search with filters (e.g., title, location, industry).
* **Enrich data**: Append or update emails, phones, and firmographics for single or bulk contacts.
* **Build integrations**: Embed lookups, searches, exports, etc., into your application.

***

## Credits & Billing

**How do credits get charged?**

| Credit Type         | When It's Used                               |
| ------------------- | -------------------------------------------- |
| **Premium Credit**  | A or A- grade email **or** valid phone       |
| **Standard Credit** | A or A- grade **email only**                 |
| **Enrich Credit**   | When the contact exists in our database      |
| **Company Credit**  | When **any** company information is returned |

**If I re-lookup the same profile, am I charged again?**\
No—re-lookups and updates are free as long as your plan is active.

**Can I use my API credits on the UI?**\
Yes! In the UI, these are called **Exports**.
1 Export = 1 API Credit

***

## Email Grades & Preferences

**What do the email grades mean?**

| Grade | Deliverability                             |
| ----- | ------------------------------------------ |
| A     | \~98% - Personal: >99%, Professional: >97% |
| A-    | \~90%                                      |
| B     | 75–85%                                     |
| F     | Invalid - o **not** send                   |

**Can I set an email preference (personal vs. professional)?**\
Yes—go to **Account Settings → Other Settings** and choose your preferred email type.
Only that type will be shown, and credits are only charged if it’s found.

***

## Search Functionality

**How can I ensure profiles with phone or email appear in search?**\
Use the `contact_method` parameter in your search call.

**Can I suppress (hide) certain profiles from search?**\
Yes—upload a **Suppression List** (via LinkedIn URL or Name & Company) in **Account Settings**.

**How are search results paginated?**

* Up to **100** profiles per page
* Max **10,000** results per query
* Narrow search with filters if over the limit

**Why doesn't the data in a profile match the API?**\
This should almost never happen. Contact support if you notice discrepancies.

**Why don't UI and API search results match?**\
The UI uses NLP for search facets. Try adjusting:

* `facet` filters
* `order_by` parameter
* Use **exact match** around values

***

## Errors & Troubleshooting

**What do these API errors mean?**\
See our [Errors Guide](#) for full explanations and troubleshooting tips.

**Why am I getting 429 (rate limited) errors?**\
Rate limits depend on your plan. Contact us to upgrade. More help: [Rate Limits](rate-limits)

***

## Teaser & Data Availability

**What does the “teaser” include?**\
A teaser gives a *hint* of data availability. Final lookups may reveal more, even if the teaser appears empty.

**Why does the teaser only show phone numbers and no emails?**\
Teaser data is only shown if it’s cached.

**Do I get charged a credit if no data is returned?**

* **Lookups**: No credit is charged if no data is found
* **Searches**: Metered, but \~10,000/day are free on paid API plans
* **B or F grade emails**: No credits are charged

**How do I know if RocketReach has data for a profile?**

* 87% of lookups return profiles
* LinkedIn URLs return data **99%** of the time
* Even if teaser is empty, final lookup may still return data due to real-time validation