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

# Introduction

> Get started with the Stardex API

## Base URL

All API requests should be made to:

```bash theme={null}
https://api.stardex.ai
```

For example, to access the `/v1/persons` endpoint, you would make a request to:

```bash theme={null}
https://api.stardex.ai/v1/persons
```

## Authentication

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

```bash theme={null}
Authorization: Bearer your_api_key_here
```

You can get your API key from the [Stardex Settings](https://stardex.ai/settings/integrations).

## Response Format

All API endpoints follow a consistent response format:

```json theme={null}
{
  "error": string | null,  // Error message if something went wrong, null on success
  "data": object | null    // Response data if successful, null on error
}
```

### Example Successful Response

```json theme={null}
{
  "error": null,
  "data": {
    "id": "123",
    "name": "John Doe"
    // ... other fields
  }
}
```

### Example Error Response

```json theme={null}
{
  "error": "Invalid API key",
  "data": null
}
```

Common HTTP Status Codes:

* `200`: Operation completed successfully
* `400`: Invalid request or missing fields
* `401`: Missing or invalid API key
* `403`: Forbidden - insufficient permissions
* `404`: Resource not found
* `500`: Unexpected server error