# Getting Started

All REST API calls will return `JSON` results.

Our API endpoint is: `https://api.enrichmentapi.io/`

## Uses

Our API is easy to use and is designed to be used by developers.\
\
Here are a few things to consider before we get started:<br>

* The request will be retried until it can be completed (up to 60 seconds). In cases where the request fails in 60 seconds, we will return a 408 error, you will not be charged for the unsuccessful API call(you are only charged for successful requests, 200 status code). Make sure to catch these errors! They will occur on roughly 1-2% of requests.
* If you exceed 50 requests per month on your free plan, you will receive a 403 error.
* Each request will return an array of objects with the requested data.

### Error Codes

Handling the HTTP response status codes below is advisable for a smooth scraping experience.

| Error Codes |              Description              |
| :---------: | :-----------------------------------: |
|     200     |           Request Successful          |
|     404     | User not found or enter a valid query |
|     408     |           Request timed out           |
|  503 or 504 |       Request couldn't proceed.       |

### Credit Cost of APIs

|            API           | Cost |
| :----------------------: | :--: |
|       Employees API      |  10  |
|        Person API        |   5  |
|        Company API       |   5  |
|  Company Investment API  |   1  |
| Reverse Email Lookup API |  10  |
|      Tech Stack API      |   1  |
|     Company To Domain    | free |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enrichmentapi.io/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.