Quick Start

Choose Your Role

Offergrid serves two distinct user types. Select the path that matches your role:

I'm a Provider

Service providers offering internet or electricity services

I'm a Reseller

Resellers helping customers find and purchase services

Quick Setup (Both Roles)

1. Create Your Account

Visit offergrid.io and click Sign Up

Choose your role

Select Provider or Reseller based on your business

Complete profile

Fill in your company information and contact details

Get verified

Complete verification (typically takes 1-2 business days)

2. Generate API Key

Go to settings

Navigate to Settings → API Keys in your dashboard

Generate key

Click Generate New API Key

Save securely

Copy the key immediately and store it in environment variables

export OFFERGRID_API_KEY="your-api-key-here"

You won’t be able to see this key again!

3. Make Your First API Call

Test your API key with a simple request:

# Providers: List your offers
curl -X GET https://api.offergrid.io/provider/offers \
  -H "x-api-key: YOUR_API_KEY"

# Resellers: Browse catalog
curl -X GET https://api.offergrid.io/reseller/catalog \
  -H "x-api-key: YOUR_API_KEY"

// Providers: List offers
const response = await fetch('https://api.offergrid.io/provider/offers', {
  headers: {
    'x-api-key': process.env.OFFERGRID_API_KEY,
  },
});

const offers = await response.json();
console.log(offers);

import requests
import os

# Providers: List offers
response = requests.get(
  'https://api.offergrid.io/provider/offers',
  headers={'x-api-key': os.environ['OFFERGRID_API_KEY']}
)

offers = response.json()
print(offers)

Provider Quick Start

Create Your First Offer

curl -X POST https://api.offergrid.io/provider/offers \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "High-Speed Internet 1000 Mbps",
    "category": "internet",
    "status": "active",
    "monthlyPrice": 59.99,
    "description": "Blazing fast fiber internet",
    "keyFeatures": ["1000 Mbps download", "Unlimited data"]
  }'

View Incoming Orders

curl -X GET https://api.offergrid.io/provider/orders \
  -H "x-api-key: YOUR_API_KEY"

Next Steps for Providers

Provider Guide

Complete provider onboarding checklist

Creating Offers

Learn how to create service offerings

Order Fulfillment

Manage incoming orders

Provider API

API integration guide

Reseller Quick Start

Browse Available Services

curl -X GET "https://api.offergrid.io/reseller/catalog?category=internet&zipCode=94102" \
  -H "x-api-key: YOUR_API_KEY"

Place Your First Order

curl -X POST https://api.offergrid.io/reseller/orders \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{ "offerId": "off-123-abc" }],
    "customerInfo": {
      "fullName": "John Doe",
      "email": "john@example.com",
      "phone": "+1-555-123-4567"
    },
    "serviceAddress": {
      "street": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "zipCode": "94102",
      "country": "US"
    }
  }'

Track Orders

curl -X GET https://api.offergrid.io/reseller/orders \
  -H "x-api-key: YOUR_API_KEY"

Next Steps for Resellers

Reseller Guide

Complete reseller onboarding checklist

Browsing Catalog

Find services for your customers

Placing Orders

Learn how to place orders

Reseller API

API integration guide

Common Questions

How long does verification take?

Account verification typically takes 1-2 business days. You’ll receive an email when your account is approved.

Can I be both a provider and reseller?

Yes! Some teams have hybrid access and can use both provider and reseller endpoints with the same API key.

Where can I find my API key?

Go to Settings → API Keys in your dashboard. If you lost your key, revoke it and generate a new one.

What are the API rate limits?

Burst: 100 requests per minute
Sustained: 10,000 requests per hour

Can I test without affecting production?

Yes, create offers with status: "draft" to test without making them visible. Work with support to create test orders.

Additional Resources

How It Works

Platform overview and workflows

Authentication

API authentication guide

API Reference

Complete API documentation

Need Help?

Contact Support

Questions? Reach out to our team at support@offergrid.io

Getting Started

Documentation

Choose Your Role

I'm a Provider

I'm a Reseller

Quick Setup (Both Roles)

1. Create Your Account

2. Generate API Key

3. Make Your First API Call

Provider Quick Start

Create Your First Offer

View Incoming Orders

Next Steps for Providers

Provider Guide

Creating Offers

Order Fulfillment

Provider API

Reseller Quick Start

Browse Available Services

Place Your First Order

Track Orders

Next Steps for Resellers

Reseller Guide

Browsing Catalog

Placing Orders

Reseller API

Common Questions

Additional Resources

How It Works

Authentication

API Reference

Need Help?

Contact Support

​Choose Your Role

I'm a Provider

I'm a Reseller

​Quick Setup (Both Roles)

​1. Create Your Account

​2. Generate API Key

​3. Make Your First API Call

​Provider Quick Start

​Create Your First Offer

​View Incoming Orders

​Next Steps for Providers

Provider Guide

Creating Offers

Order Fulfillment

Provider API

​Reseller Quick Start

​Browse Available Services

​Place Your First Order

​Track Orders

​Next Steps for Resellers

Reseller Guide

Browsing Catalog

Placing Orders

Reseller API

​Common Questions

​Additional Resources

How It Works

Authentication

API Reference

​Need Help?

Contact Support

Choose Your Role

Quick Setup (Both Roles)

1. Create Your Account

2. Generate API Key

3. Make Your First API Call

Provider Quick Start

Create Your First Offer

View Incoming Orders

Next Steps for Providers

Reseller Quick Start

Browse Available Services

Place Your First Order

Track Orders

Next Steps for Resellers

Common Questions

Additional Resources

Need Help?