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

# API Introduction

> Integrate GrowEasy into your applications

## Welcome to the GrowEasy API

The GrowEasy API allows you to programmatically start scrapes, check status, manage credits, and find/verify emails. Build custom integrations and automate your lead generation workflows.

<CardGroup cols={2}>
  <Card title="Start Scrape" icon="rocket" href="/api-reference/endpoint/start">
    Start a new scrape with filters
  </Card>

  <Card title="Check Status" icon="clock" href="/api-reference/endpoint/status">
    Get the status of a scrape job
  </Card>

  <Card title="Find Email" icon="envelope" href="/api-reference/endpoint/email-find">
    Find business emails for leads
  </Card>

  <Card title="Verify Email" icon="check" href="/api-reference/endpoint/email-verify">
    Verify email deliverability
  </Card>
</CardGroup>

## Authentication

All API endpoints require authentication using Bearer tokens. Include your API key in the Authorization header:

```bash theme={null}
curl -X GET "https://api.groweasy.io/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Get your API key from the [GrowEasy dashboard](https://app.groweasy.io/settings/api).

## Base URL

All API requests should be made to:

```
https://api.groweasy.io
```

## Rate Limits

* **Starter plan**: 60 requests per minute
* **Pro plan**: 300 requests per minute
* **Enterprise**: Custom limits

## Response Format

All responses are returned in JSON format:

```json theme={null}
{
  "success": true,
  "data": {
    // Response data
  }
}
```

## Error Handling

Errors follow a consistent format:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Description of the error"
  }
}
```

### Common Error Codes

| Code                   | Description                                              |
| ---------------------- | -------------------------------------------------------- |
| `INVALID_REQUEST`      | The request body is malformed or missing required fields |
| `UNAUTHORIZED`         | Invalid or missing API key                               |
| `INSUFFICIENT_CREDITS` | Not enough credits to complete the operation             |
| `NOT_FOUND`            | The requested resource was not found                     |
| `RATE_LIMIT_EXCEEDED`  | Too many requests, slow down                             |

## Need Help?

Contact our developer support at [api-support@groweasy.io](mailto:api-support@groweasy.io).