GOB Logo
Join Waitlist
Coming Soon
Early Access

Build on
Nigeria's
Action Economy.

The GOB API gives developers and businesses direct access to our task distribution engine, reward payout system, bill payment rails, and user verification infrastructure.

Task Distribution Reward Payouts Bill Payments User KYC Campaign Analytics Webhooks SDKs
Join the Waitlist Preview the API
gob-api-example.js 
// Initialize GOB API Client
import { GobClient } from '@gob/api-sdk';

const gob = new GobClient({
  apiKey: 'gob_live_xxxxxxxxxxxx',
  env: 'production'
});

// Create a new task campaign
const campaign = await gob.campaigns.create({
  type:        'social_media',
  title:       'Follow @YourBrand on Instagram',
  reward:      200,    // ₦ per completion
  target:      500,    // number of users
  proof:       'screenshot'
});

// Response
{
  id:      'camp_9xKf2mNp',
  status:  'live',
  budget:  100000,    // ₦100,000 escrowed
  eta:     '~24hrs'
}

SDK Support Planned For

JavaScript Python PHP Node.js React Native Flutter Dart Go Ruby Java Swift Kotlin JavaScript Python PHP Node.js React Native Flutter Dart Go Ruby Java Swift Kotlin
What You'll Be Able To Build

Everything You Need. One API.

Programmatic access to GOB's entire platform — tasks, rewards, payments, and analytics — all through clean REST endpoints.

Task Campaigns

Create, update, pause, and monitor task campaigns programmatically. Set rewards, proof types, targets, and geofencing rules via API call.

Reward Payouts

Trigger instant NGN payouts to verified GOB users upon task completion. Fully automated escrow release via webhook.

Bill Payments

Integrate airtime, data, electricity, and betting top-ups directly into your app using GOB's discounted payment rails.

User Verification

Verify Nigerian users with our KYC layer — BVN verification, phone number lookup, and identity status checks.

Campaign Analytics

Pull real-time campaign stats: completions, proof submissions, spend velocity, ROI estimates, and user demographics.

Webhooks

Subscribe to live events — task_completed, reward_paid, campaign_ended, user_verified — and react in real time.

API Key Management

Generate and rotate API keys, set rate limits, IP whitelisting, and sandbox vs. live environment switching.

REST + JSON

Clean, predictable RESTful endpoints with JSON responses. OpenAPI 3.0 spec included. No SOAP, no XML.

Fast Response

Sub-200ms average response times on all read endpoints. Designed for real-time applications and dashboards.

API Endpoints Preview

A glimpse at the endpoints available in the GOB API. Full documentation releases with the API launch.

GET /v1/campaigns
POST /v1/campaigns/create
GET /v1/campaigns/{id}/stats
POST /v1/tasks/distribute
POST /v1/rewards/payout
GET /v1/users/verify
POST /v1/bills/airtime
POST /v1/bills/data
GET /v1/analytics/roi
POST /v1/webhooks/subscribe
Preview available  ·  Unlocks at launch
Request POST 
POST https://api.gob.ng/v1/campaigns/create
Authorization: Bearer gob_live_xxxxxxxxxxxx
Content-Type:  application/json

{
  "type":    "social_media",
  "title":   "Follow @YourBrand",
  "platform":"instagram",
  "action":  "follow",
  "reward":  200,
  "target":  500,
  "proof":   "screenshot"
}
Response 200 OK 200 OK 
{
  "success":    true,
  "campaign": {
    "id":       "camp_9xKf2mNp",
    "status":   "live",
    "budget":   100000,
    "escrowed": true,
    "target":   500,
    "completed":0,
    "eta":      "~24hrs",
    "created_at":"2025-06-01T09:41:00Z"
  },
  "webhook_url":"https://api.gob.ng/webhooks/..."
}

Who Should Integrate

The GOB API is designed for builders who need real Nigerian user actions at scale, delivered programmatically.

Marketplaces

Embed task distribution and reward payouts into your existing marketplace — reward users for reviews, purchases, and referrals.

Music Platforms

Automate streaming promotion campaigns. Connect your Spotify/YouTube analytics and trigger GOB campaigns based on real metrics.

Mobile Apps

Integrate GOB's reward rails into your app to power loyalty programs, onboarding tasks, and in-app incentives for Nigerian users.

Agencies & DSPs

Run programmatic brand campaigns across multiple clients from one dashboard. Automate reporting and payout reconciliation.

API Launching Soon — Join Early

Be First to
Build with GOB.

Drop your email and we'll notify you the moment the GOB API goes live — plus early access, reduced rate limits, and priority developer support.

200+ developers already waiting No spam, ever Early access perks included

What Ships at Launch

Everything you need to start building production-ready integrations from day one.

REST API — Core Endpoints

v1.0

Campaigns, tasks, rewards, bill payments, user lookup. Full CRUD on campaign management.

API Key Dashboard

v1.0

Generate keys, set scopes, rotate credentials, and manage rate limits from the GOB Partner Dashboard.

Webhook Events

v1.0

Real-time event delivery for task_completed, reward_paid, campaign_ended, user_verified, and more.

Sandbox Environment

v1.0

Full test environment with mock users, simulated completions, and test payments — no real money involved.

JavaScript & Python SDKs

v1.1

Official client libraries with TypeScript support, async/await patterns, and comprehensive error handling.

PHP & Flutter SDKs

v1.1

Native PHP (Laravel-ready) and Flutter/Dart packages for mobile-first and backend developers.

OpenAPI 3.0 Spec & Docs

v1.1

Fully interactive API documentation with live request testing, code examples in 6 languages.

Campaign Analytics API

v1.2

Deep reporting: user demographics, completion velocity, geographic breakdowns, ROI calculations.

Batch Operations

v1.2

Create, update, or close multiple campaigns in a single API call. Bulk reward payouts.

Questions About the API?

Reach out to our developer team. Whether you're planning an integration or want to discuss enterprise access, we're here.

Email Developer Team WhatsApp Us

info@gob.ng  ·  +234 9061 480 959  ·  @gobonlineng