# Overview

## Base URL

```
https://pub-api.conversion.ai/api
```

## Authentication

All requests must include your API key in the header:

```
X-API-Key: YOUR_API_KEY
```

## Response Format

All API responses follow this standard format:

**Success Response:**

Standard JSON format.

**Error Response:**

```json
{
  "message": "User is not found."
}
```

## HTTP Response Codes

<table><thead><tr><th width="122.109375">Code</th><th width="196.22265625">Status</th><th>Description</th></tr></thead><tbody><tr><td><code>200</code></td><td>OK</td><td>Success</td></tr><tr><td><code>400</code></td><td>Bad Request</td><td>Your request was invalid</td></tr><tr><td><code>401</code></td><td>Unauthorized</td><td>Invalid or missing API key</td></tr><tr><td><code>403</code></td><td>Forbidden</td><td>Your API key does not have permissions for the requested resource</td></tr><tr><td><code>404</code></td><td>Not Found</td><td>The requested resource does not exist</td></tr><tr><td><code>429</code></td><td>Too Many Requests</td><td>You've hit our API rate limits</td></tr><tr><td><code>500</code></td><td>Server Error</td><td>Something went wrong on Conversion's end</td></tr></tbody></table>

## Best Practices

1. **Batch Operations**: Use batch endpoints when uploading multiple records to reduce API calls
2. **Error Handling**: Always check the response code is `200` before processing response data
3. **Validation**: Validate email formats and required fields before sending requests
4. **Monitoring**: Monitor API response times and error rates for optimal performance