> ## 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

> Introduction to the Meibel REST API for parsing documents, managing datasources, running agents, and extracting structured data.

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)