Coming Soon
lock 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
api 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.

campaign

Task Campaigns

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

payments

Reward Payouts

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

receipt_long

Bill Payments

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

verified_user

User Verification

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

bar_chart

Campaign Analytics

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

webhook

Webhooks

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

key

API Key Management

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

code

REST + JSON

Clean, predictable RESTful endpoints with JSON responses. OpenAPI 3.0 spec included.

bolt

Fast Response

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

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 lock
POST /v1/rewards/payout lock
GET /v1/users/verify lock
POST /v1/bills/airtime lock
POST /v1/bills/data lock
GET /v1/analytics/roi lock
POST /v1/webhooks/subscribe lock
Preview available  ·  lock 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 
{
  "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.

storefront

Marketplaces

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

music_note

Music Platforms

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

phone_android

Mobile Apps

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

business

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.

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

What Ships at Launch

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

check_circle

REST API — Core Endpoints

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

v1.0

check_circle

API Key Dashboard

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

v1.0

check_circle

Webhook Events

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

v1.0

check_circle

Sandbox Environment

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

v1.0

schedule

JavaScript & Python SDKs

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

v1.1

schedule

PHP & Flutter SDKs

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

v1.1

schedule

OpenAPI 3.0 Spec & Docs

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

v1.1

schedule

Campaign Analytics API

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

v1.2

schedule

Batch Operations

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

v1.2

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.

mail Email Developer Team WhatsApp Us

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