# 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


---

# 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://api-docs.conversion.ai/overview.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.
