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

# Quickstart

> Get started with the VoxFi Public API in minutes

## Introduction

The VoxFi Public API allows you to interact with the VoxFi platform programmatically. All endpoints require authentication using an API key that you generate in your account settings.

## Get Your API Key

1. Log in to your VoxFi account
2. Navigate to **Profile** → **Security**
3. Generate a new API key
4. Copy and securely store your API key (you won't be able to see it again)

<Warning>
  Keep your API key secure and never share it publicly. Treat it like a password.
</Warning>

## Base URL

All API requests should be made to:

```
https://data-api-dev.voxfi.com.br/v1
```

## Authentication

Every request to the API must include your API key in the request headers:

```bash theme={null}
X-Api-Key: your-api-key-here
```

## Your First Request

Let's start by fetching a list of available events:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://data-api-dev.voxfi.com.br/v1/data/events" \
    -H "X-Api-Key: your-api-key-here"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://data-api-dev.voxfi.com.br/v1/data/events', {
    method: 'GET',
    headers: {
      'X-Api-Key': 'your-api-key-here'
    }
  });

  const events = await response.json();
  console.log(events);
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'X-Api-Key': 'your-api-key-here'
  }

  response = requests.get('https://data-api-dev.voxfi.com.br/v1/data/events', headers=headers)
  events = response.json()
  print(events)
  ```
</CodeGroup>

## Rate Limits

The API implements rate limiting to ensure fair usage. Rate limit information is returned in response headers when limits are approached.

## Next Steps

* Explore the [API Reference](/reference) for detailed endpoint documentation
* Check out [Authentication](/authentication) for more security best practices
* Review [Error Handling](/errors) to understand API error responses