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

# Introduction

> Overview of the Cardano Governance Explorer API

# API Reference

<Note>
  **AI-Powered Analytics**: The Cardano Governance Explorer API provides AI-enhanced endpoints to query and analyze Cardano's on-chain governance data using natural language.
</Note>

The API enables developers to access and integrate the power of our AI-driven blockchain governance analytics into their own applications, providing seamless access to DRep data, proposal analysis, and vote rationale insights.

## API Structure

The Cardano Governance Explorer API is divided into three main categories, each serving a specific purpose:

<CardGroup cols={3}>
  <Card title="DRep API" icon="user-gear" href="/api-reference/drep-api">
    Explore and filter Delegated Representatives (DReps) using natural language queries
  </Card>

  <Card title="Proposal API" icon="file-contract" href="/api-reference/proposal-api">
    Analyze governance proposals with AI-powered insights
  </Card>

  <Card title="Rationale API" icon="magnifying-glass-chart" href="/api-reference/rationale-api">
    Extract insights from voting rationales across stakeholder groups
  </Card>
</CardGroup>

## Authentication

<Check>
  **API Key Required**: All API endpoints require an API key for authentication.
</Check>

Include your API key in the header of all requests:

```bash theme={null}
x-api-key: YOUR_API_KEY
```

To obtain an API key, register at the [Cardano Governance Explorer Dashboard](https://syncgovhub.com/app).

## Base URL

All API requests should be made to:

```plaintext theme={null}
https://api.syncgovhub.com
```

## Request Format

All API endpoints accept POST requests with a JSON body. Make sure to set the appropriate headers:

```bash theme={null}
x-api-key: YOUR_API_KEY
```

## Response Format

All API responses follow a consistent structure:

```json theme={null}
{
  "data": {
    // The main response data
  },
  "meta": {
    // Metadata about the request and response
    "timings": {
      // Performance metrics
    }
  }
}
```

## Error Handling

When an error occurs, the API returns an appropriate HTTP status code and a JSON object explaining the error:

```json theme={null}
{
  "error": "Descriptive error message",
  "details": "Additional information when available"
}
```

Common HTTP status codes:

| Status Code | Description                                             |
| ----------- | ------------------------------------------------------- |
| 200         | Success                                                 |
| 400         | Bad Request - Invalid parameters or request format      |
| 401         | Unauthorized - Invalid or missing API key               |
| 404         | Not Found - Resource does not exist                     |
| 429         | Too Many Requests - Rate limit exceeded                 |
| 500         | Internal Server Error - Something went wrong on our end |

## Rate Limiting

To ensure service stability, API requests are rate-limited to:

* 60 requests per minute per API key
* 1,000 requests per day per API key

If you exceed these limits, you'll receive a `429 Too Many Requests` status code.

## Support

If you encounter any issues or have questions about the API, reach out to our support team at [adnan@syncai.pro](mailto:adnan@syncai.pro).