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

# Getting Started

> Understanding the basics of CaptureIQ's API.

# API Documentation

## Getting Started

Understanding the basics of CaptureIQ's API.

<Note>
  Please note that CaptureIQ's API is currently in beta. We welcome any
  questions or feedback you may have. Feel free to reach out to us at
  [support@captureiq.ai](mailto:support@captureiq.ai).
</Note>

## Base URL

The CaptureIQ API is built on REST principles and is served over HTTPS.

The Base URL for all API endpoints is:

```bash theme={null}
https://app.captureiq.ai
```

## Authentication

To access CaptureIQ's API, you need to authenticate using a Bearer token. Include the token in the Authorization header of your API requests like this:

```bash theme={null}
Authorization: Bearer <Your-Token>
```

You can generate a new token/API key under your Account Settings. This token is valid for 180 days, post that need to generate a new key in settings

<img className="block dark:hidden" src="https://mintcdn.com/captureiq-117e92e1/EmAZL_MMQUGekYJJ/images/apikey.png?fit=max&auto=format&n=EmAZL_MMQUGekYJJ&q=85&s=95cab8603a71a3f5be852f6cfc46fcfb" alt="Hero Light" width="1512" height="590" data-path="images/apikey.png" />

## Workspace ID

CaptureIQ's API is organized around workspaces. To access a workspace's resources, include the workspaceId parameter in your API requests either in the query param or request body:

```bash theme={null}
https://app.captureiq.ai/forms?workspaceId=<Your-Workspace-ID>
```

You can get your workspace ID under your Settings.

<img className="block dark:hidden" src="https://mintcdn.com/captureiq-117e92e1/EmAZL_MMQUGekYJJ/images/workspaces.png?fit=max&auto=format&n=EmAZL_MMQUGekYJJ&q=85&s=2a1f54eb280da1bdce122e16186e8cfd" alt="Hero Light" width="1328" height="682" data-path="images/workspaces.png" />

<img className="hidden dark:block" src="https://mintcdn.com/captureiq-117e92e1/sxnwB9FdllRP_xWM/images/intro-ciq.avif?fit=max&auto=format&n=sxnwB9FdllRP_xWM&q=85&s=532ee945f554087dc6e87deda7f5e578" alt="Hero Dark" width="2752" height="1706" data-path="images/intro-ciq.avif" />

## Response Codes

The API returns standard HTTP response codes to indicate the success or failure of an API request. Here are a few examples:

| Code | Description                                                                                    |
| ---- | ---------------------------------------------------------------------------------------------- |
| 200  | The request was successful.                                                                    |
| 400  | The request was invalid or cannot be served.                                                   |
| 401  | The request requires user authentication.                                                      |
| 403  | The server understood the request, but refuses to authorize it.                                |
| 404  | The requested resource could not be found.                                                     |
| 429  | Too many requests.                                                                             |
| 500  | The server encountered an unexpected condition which prevented it from fulfilling the request. |

## Rate limits

CaptureIQ's API enforces a rate limit of 60 requests per minute per user.

This limitation is in place to promote fair usage and prevent any single user from disproportionately impacting the performance and availability of the API for others.

If you exceed the rate limit, you will receive a 429 Too Many Requests response code. This indicates that your request cannot be processed at the moment due to exceeding the allowed number of requests within the specified timeframe.