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

# Polinate API

> External Polinate API Documentation

# Welcome

This documentation is for implementation partners and software integrations working with the Polinate API. You'll find high-level guidance for how our resources fit together, plus minimal, copy‑paste examples to get you moving quickly. The full request/response details live in the API Reference.

<Note>
  New to the API? Start with the Basics, then explore resource-specific guides.
</Note>

## Basics

<CardGroup cols={3}>
  <Card title="Authentication" icon="key" href="/guides/authentication">
    Required headers and how to get credentials
  </Card>

  <Card title="Idempotency" icon="repeat" href="/guides/idempotency">
    Safe retries for POST requests
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/guides/rate-limits">
    Token bucket model and handling 429s
  </Card>
</CardGroup>

## Resources

<CardGroup cols={4}>
  <Card title="Items" icon="box" href="/guides/items">
    Item bundles with variants (Shopify-like model)
  </Card>

  <Card title="Buyers" icon="users" href="/guides/buyers">
    Buyer bundles, partnerships, and contact ownership
  </Card>

  <Card title="Pricing" icon="tag" href="/guides/pricing">
    Create price lists and entries
  </Card>

  <Card title="Orders" icon="receipt" href="/guides/orders">
    List filters (created/updated/modified), pagination, idempotent ingestion
  </Card>
</CardGroup>

## API Reference

<CardGroup cols={1}>
  <Card title="OpenAPI" icon="book" href="/api-reference">
    Full endpoint specs, request/response schemas, and error formats
  </Card>
</CardGroup>