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

# API Reference

> Get started with the Meibel API

Welcome to the Meibel API reference documentation. Our API allows you to interact with all our services programmatically.

## Overview

The Meibel API enables developers to:

* Parse documents into structured markdown with confidence scoring
* Create and manage datasources and data elements for contextual retrieval
* Search and query across your data
* Manage content, metadata, and tag descriptions

## Authentication

All API requests require authentication using an API key sent in the `Meibel-API-Key` header.

```bash theme={null}
curl -X GET https://api.meibel.ai/v2/datasources \
  -H "Meibel-API-Key: YOUR_API_KEY"
```

## Rate Limits

The Meibel API implements rate limiting to ensure fair usage across all users. Rate limits vary by endpoint and are specified in the HTTP headers of API responses:

* `X-RateLimit-Limit`: The maximum number of requests you're permitted to make per time period
* `X-RateLimit-Remaining`: The number of requests remaining in the current rate limit window
* `X-RateLimit-Reset`: The time at which the current rate limit window resets (UTC epoch seconds)

If you exceed the rate limit, an error response returns with status code 429 (Too Many Requests).

## SDK Support

We provide official SDKs to make integration easier:

<CardGroup cols={4}>
  <Card title="Python" icon="python" href="/sdk/python">
    Sync and async support
  </Card>

  <Card title="TypeScript" icon="js" href="/sdk/nodejs">
    Full type safety with Zod
  </Card>

  <Card title="Go" icon="golang" href="/sdk/go">
    Idiomatic Go interface
  </Card>

  <Card title="CLI" icon="terminal" href="/sdk/cli">
    Command-line interface
  </Card>
</CardGroup>

## Getting Started

To start using the Meibel API:

<Steps>
  <Step title="Sign up for an account">
    Create an account at [app.meibel.ai](https://app.meibel.ai)
  </Step>

  <Step title="Generate an API key">
    Create an API key in the dashboard under Settings > API Keys
  </Step>

  <Step title="Make your first API call">
    Follow the [installation guide](/installation) to make your first API call
  </Step>
</Steps>

<Note>
  All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.
</Note>

## Need help?

If you encounter any issues, you can:

* Check the [installation guide](/installation)
* Email our support team at [support@meibel.ai](mailto:support@meibel.ai)
* Open an issue on [GitHub](https://github.com/meibel-ai)