Skip to main content

API Key & Authentication

Getting Your API Key​

To use the Reachu API, you need to get an API key from your dashboard:

  1. Sign up at dashboard.reachu.io
  2. Create a new channel in your dashboard
  3. Copy your API key from the channel settings

🚀 Start Testing Immediately​

You can start testing right away with our demo API key:

CFN9A5W-V74MACA-K2XD00S-W2D42D3

This demo key gives you access to:

  • ✅ Sample products from our test catalog
  • ✅ Complete cart and checkout flow
  • ✅ All API endpoints for testing
  • ✅ Real API responses (test environment)

Note: This is a shared demo key for testing purposes. For production use, create your own API key in the dashboard.

Using Your API Key​

Include your API key in the Authorization header. Important: All product operations go through your channel context, not directly to products.

Try It Now - Get Channel Products​

GET
/api/channel/products

Get all products from your channel

Try It Now - Get Channel Information​

GET
/api/channel/me

Get your channel information and configuration

Traditional cURL Examples:​

# Get products from YOUR channel (not direct product access)
curl -X GET "https://api-qa.reachu.io/api/channel/products" \
  -H "Authorization: CFN9A5W-V74MACA-K2XD00S-W2D42D3" \
  -H "Content-Type: application/json"

# Get channel information
curl -X GET "https://api-qa.reachu.io/api/channel/me" \
  -H "Authorization: CFN9A5W-V74MACA-K2XD00S-W2D42D3"

Demo & Examples​

Live Demo​

Try our interactive demo: Book a Demo

Sample Requests​

// JavaScript example - Getting products from YOUR channel
const response = await fetch('https://api-qa.reachu.io/api/channel/products', {
  headers: {
    'Authorization': 'CFN9A5W-V74MACA-K2XD00S-W2D42D3',
    'Content-Type': 'application/json'
  }
});

// Get channel information
const channelInfo = await fetch('https://api-qa.reachu.io/api/channel/me', {
  headers: {
    'Authorization': 'CFN9A5W-V74MACA-K2XD00S-W2D42D3'
  }
});

Postman Collection​

📋 Download our complete Postman collection with all API endpoints, examples, and pre-configured variables:

Download Reachu Postman Collection →

What's included in the collection:​

  • ✅ Cart Management - Create, update, and manage shopping carts
  • ✅ Checkout Process - Complete checkout flow with payment methods
  • ✅ Product Operations - Get products, categories, and supplier information
  • ✅ Payment Integration - Stripe, Klarna, and Vipps payment methods
  • ✅ Pre-configured Variables - Ready-to-use environment variables
  • ✅ Sample API Key - Example authentication header

Quick Start with Postman:​

  1. Download the collection file above
  2. Import it into Postman
  3. Replace the API key with your own
  4. Start testing the API endpoints

Environment Variables:​

The collection includes these pre-configured variables:

  • api: https://api-qa.reachu.io
  • cartId: Sample cart ID for testing
  • productId: Sample product ID
  • checkoutId: Sample checkout ID
  • And more...

Common API Workflows​

Try Complete Purchase Flow​

Step 1: Create a Cart

POST
/api/cart

Create a new shopping cart

{
  "customer_session_id": "my-session-id-01",
  "currency": "NOK"
}

Step 2: Add Items to Cart

POST
/api/cart/{cartId}/item/add

Add products to your cart (replace {cartId} with actual cart ID from step 1)

{
  "line_items": [
    {
      "product_id": 68787,
      "quantity": 1,
      "shipping_id": "SHIPPING_ID"
    }
  ]
}

Step 3: Create Checkout

POST
/api/checkout

Initialize checkout process (replace CART_ID with actual cart ID)

{
  "cart_id": "CART_ID"
}

Traditional cURL Examples:​

# 1. Create a cart
curl -X POST "https://api-qa.reachu.io/api/cart" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_session_id": "my-session-id-01",
    "currency": "NOK"
  }'

# 2. Add items to cart
curl -X POST "https://api-qa.reachu.io/api/cart/CART_ID/item/add" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "line_items": [{
      "product_id": 68787,
      "quantity": 1,
      "shipping_id": "SHIPPING_ID"
    }]
  }'

# 3. Create checkout
curl -X POST "https://api-qa.reachu.io/api/checkout" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cart_id": "CART_ID"}'