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

# Quick Start

## Obtain a Token

The Cariqa Connect API uses **JWT-based Bearer tokens** for authentication. How to obtain it:

1. [Contact](mailto:sales@cariqa.com) our team for manual onboarding and provide the required information
2. We will send you:
   1. API tokens for development and production environments
   2. Stripe publishable key required for client-side payment method collection
3. We will also verify your domains for Apple Pay and Google Pay
4. Go ahead and make your first API request

**You'll need to provide:**

* Company details and use case
* Technical contact information
* Domain(s) for Apple Pay/Google Pay verification

<CardGroup cols={2} />

### First API Request

Once you get your API Token, store it securely and try your first API call

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://connect.cariqa.com/api/v1/stations/around/?latitude=49.630383&longitude=8.368902&distance=10" \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json"
  ```

  ```python Python theme={null}
  import requests

  headers = {
      "Authorization": "Bearer YOUR_API_TOKEN",
      "Content-Type": "application/json"
  }

  response = requests.get(
      "https://connect.cariqa.com/api/v1/stations/around/",
      headers=headers,
      params={
          "latitude": 49.630383,
          "longitude": 8.368902,
          "distance": 10
      }
  )
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://connect.cariqa.com/api/v1/stations/around/?latitude=49.630383&longitude=8.368902&distance=10', {
    headers: {
      'Authorization': 'Bearer YOUR_API_TOKEN',
      'Content-Type': 'application/json'
    }
  });
  ```
</CodeGroup>

### Stripe Integration

The Stripe SDK must be integrated into your frontend application to allow users to securely add their favourite payment methods. This ensures compliance with PSD2/SCA requirements: payment details are handled and stored by Stripe, not Cariqa.

<Warning>
  **You must integrate [Stripe SDK on your frontend](/payments-frontend-setup): this is a hard requirement** for PSD2 compliance.
</Warning>

## Ready

You are set! Explore the [API Reference ](/getting-started)or follow our [Guides](/complete-examples) and start integrating with Cariqa Connect API. Our support is always at your disposal in case of troubles (we recommend to check the [Toubleshooting](/troubleshooting) section first).
