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

# Making Authenticated Request

> Describes how to use API Key and x-organization-id to make an authorized request.

<Note>
  **Important**: Kintsugi uses API key authentication via headers, **not** bearer token authentication. You must include both the API key and organization ID in request headers.
</Note>

## Prerequisite

<Steps>
  <Step>
    Make sure you have an API key. Refer [Creating and managing API Keys](/docs/creating-and-managing-api-keys).
  </Step>

  <Step>
    Make sure you have your organization ID. You can find it in the **lower left-hand corner** after logging into the [Kintsugi Platform](https://app.trykintsugi.com).
  </Step>
</Steps>

## Making Requests

<Steps>
  <Step>
    Now that you have the API Key and Organization ID, you're ready to make authorized requests to the Kintsugi API.
  </Step>

  <Step>
    **API Key Header**: Set your API key in the header with the key `x-api-key` (lowercase with hyphens):

    ```bash theme={null}
    curl -H "x-api-key: your-api-key" \
         https://api.trykintsugi.com/v1/tax/estimate
    ```

    <Frame>
      <img src="https://mintcdn.com/kintsugi/p4CB3kRGaA9X9Y_F/images/docs/678ae33-Screenshot_2024-04-06_at_5.35.14_AM.png?fit=max&auto=format&n=p4CB3kRGaA9X9Y_F&q=85&s=a7c5e3f23c7d42a408495cd8ea4ad1ea" alt="API Key Header" width="942" height="846" data-path="images/docs/678ae33-Screenshot_2024-04-06_at_5.35.14_AM.png" />
    </Frame>
  </Step>

  <Step>
    **Organization ID Header**: For most requests, you also need to set the organization ID in the header with the key `x-organization-id` (lowercase with hyphens):

    ```bash theme={null}
    curl -H "x-api-key: your-api-key" \
         -H "x-organization-id: your-org-id" \
         https://api.trykintsugi.com/v1/tax/estimate
    ```

    <Frame>
      <img src="https://mintcdn.com/kintsugi/p4CB3kRGaA9X9Y_F/images/docs/ed87fe26a3e22ecb5783a90128745c775fc525e745fc82fc722d219823f56352-Screenshot_2025-03-03_at_11.06.23_PM.png?fit=max&auto=format&n=p4CB3kRGaA9X9Y_F&q=85&s=247cb5d43184eb03c20a740f5001a2c7" alt="Organization ID Header" width="1300" height="286" data-path="images/docs/ed87fe26a3e22ecb5783a90128745c775fc525e745fc82fc722d219823f56352-Screenshot_2025-03-03_at_11.06.23_PM.png" />
    </Frame>
  </Step>
</Steps>

## Authentication Format

Kintsugi API uses **header-based API key authentication**, not bearer token authentication. Every request requires:

1. **`x-api-key`** header with your API key
2. **`x-organization-id`** header with your organization ID

Both headers are required for authentication. The organization ID ensures requests are scoped to the correct organization.

## Finding Your Organization ID

Your Organization ID can be found in the **lower left-hand corner** of the Kintsugi Platform dashboard after you log in. It's displayed as a unique identifier for your organization.