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

# Introduction

> Use the PriceOS API or SDKs from your backend

<Note>Check out our [integration guide](/backend-integration) to get started.</Note>

## Base URL

`https://api.priceos.com`

## Authorization

Send your [API key](https://app.priceos.com/settings/api-keys) in the `x-api-key` header on every request.

<CodeGroup>
  ```ts Node.js theme={null}
  const response = await fetch("https://api.priceos.com/v1/feature-access?customerId=customer_123", {
    headers: {
      "x-api-key": process.env.PRICEOS_API_KEY!,
    },
  });
  ```

  ```bash cURL theme={null}
  curl -X GET "https://api.priceos.com/v1/feature-access?customerId=customer_123" \
    -H "x-api-key: PRICEOS_API_KEY"
  ```
</CodeGroup>

Never expose your API key in client-side code.

## Postman collection

<a href="/files/priceos.postman_collection" download>Download Postman collection</a>

## Rate limits

Rate limits are applied per API key (`x-api-key`) using a fixed 10-second window.

* All routes: `1000` requests per `10` seconds per API key.
* `PUT`, `POST`, `DELETE` routes: `500` requests per `10` seconds per API key.

If you exceed a limit, the API returns `429 Too Many Requests`.
