The GOB API is coming soon.
Build GOB’s task campaigns, reward payouts, bill payments and user verification into your own app or platform. Join the waitlist and we’ll email you when early access opens.
// Preview: names may change before launch
import { Gob } from '@gob/api';
const gob = new Gob({ apiKey: process.env.GOB_API_KEY });
// Create a task campaign
const campaign = await gob.campaigns.create({
type: 'social_follow',
title: 'Follow @yourbrand on Instagram',
reward: 200, // naira per completion
target: 500, // completions wanted
proof: 'screenshot',
});
console.log(campaign.status); // 'in_review'# Preview: names may change before launch
import os
from gob import Gob
gob = Gob(api_key=os.environ["GOB_API_KEY"])
# Create a task campaign
campaign = gob.campaigns.create(
type="social_follow",
title="Follow @yourbrand on Instagram",
reward=200, # naira per completion
target=500, # completions wanted
proof="screenshot",
)
print(campaign.status) # 'in_review'// Preview: names may change before launch
use Gob\Api\Gob;
$gob = new Gob(getenv('GOB_API_KEY'));
// Create a task campaign
$campaign = $gob->campaigns->create([
'type' => 'social_follow',
'title' => 'Follow @yourbrand on Instagram',
'reward' => 200, // naira per completion
'target' => 500, // completions wanted
'proof' => 'screenshot',
]);
echo $campaign->status; // 'in_review'# Preview: names may change before launch
curl -X POST "https://api.gob.ng/v1/campaigns" \
-H "Authorization: Bearer $GOB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "social_follow",
"title": "Follow @yourbrand on Instagram",
"reward": 200,
"target": 500,
"proof": "screenshot"
}'What you’ll be able to build
One API for GOB’s tasks, rewards and payments.
Plain REST endpoints with JSON in and out, API keys you control, and a sandbox to test in before anything real moves.
Task campaigns
Create, pause and track task campaigns from your own systems. Set rewards, proof types, targets and locations.
Reward payouts
Pay verified GOB users in naira when their task is approved, released automatically from campaign escrow.
Bill payments
Sell airtime, data, electricity and betting top-ups inside your app, on GOB’s payment rails.
User verification
Check whether a GOB user has completed identity verification before you reward or pay them.
Campaign analytics
Completions, proof submissions, spend and results for every campaign, ready for your dashboards.
Webhooks
Get notified the moment something happens: task completed, reward paid, campaign ended, user verified.
Endpoint preview
A first look at the endpoints.
Pick an endpoint to see a sample request and response. These are planned, so paths and fields may change before launch.
POSThttps://api.gob.ng/v1/campaigns
Request
{
"type": "social_follow",
"title": "Follow @yourbrand on Instagram",
"reward": 200,
"target": 500,
"proof": "screenshot"
}Response 200 OK
{
"id": "camp_9xKf2mNp",
"status": "in_review",
"budget": 100000,
"escrowed": true,
"completed": 0
}GEThttps://api.gob.ng/v1/campaigns/{id}
Request
// No body. Pass the campaign id in the path.Response 200 OK
{
"id": "camp_9xKf2mNp",
"status": "live",
"target": 500,
"completed": 312,
"pending_review": 18,
"spent": 62400
}POSThttps://api.gob.ng/v1/rewards/payouts
Request
{
"campaign_id": "camp_9xKf2mNp",
"submission_id": "sub_41Qa",
"amount": 200
}Response 200 OK
{
"id": "pay_7Hn2",
"status": "paid",
"amount": 200,
"paid_at": "2026-10-01T09:41:00Z"
}POSThttps://api.gob.ng/v1/bills/airtime
Request
{
"phone": "08031234567",
"amount": 1000
}Response 200 OK
{
"id": "bill_2Kd9",
"status": "successful",
"network": "MTN",
"amount": 1000
}GEThttps://api.gob.ng/v1/users/{id}/verification
Request
// No body. Pass the GOB user id in the path.Response 200 OK
{
"user_id": "usr_58Tz",
"kyc_status": "verified",
"verified_at": "2026-08-14T12:03:00Z"
}POSThttps://api.gob.ng/v1/webhooks
Request
{
"url": "https://yourapp.com/gob/webhooks",
"events": ["task.completed", "reward.paid"]
}Response 200 OK
{
"id": "wh_3Lm8",
"status": "active",
"secret": "whsec_…"
}Who it’s for
For builders who need real Nigerian users.
If your product rewards, pays or verifies people in Nigeria, the GOB API is being built for you.
Marketplaces
Reward customers for reviews, purchases and referrals, paid out through GOB.
Music and media
Run streaming and promotion campaigns, and track what real listeners did.
Mobile apps
Power loyalty programmes, onboarding tasks and in-app rewards for Nigerian users.
Agencies
Run campaigns for many clients from one integration, with reporting and payouts handled.
Roadmap
What we plan to ship.
The first release covers everything you need for a working integration. SDKs and deeper reporting follow.
- v1.0Core REST APICampaigns, tasks, reward payouts, bill payments and user lookups.Planned
- v1.0API keysCreate, scope and rotate keys, with rate limits, from a partner dashboard.Planned
- v1.0WebhooksReal-time events for completed tasks, paid rewards, ended campaigns and verified users.Planned
- v1.0SandboxA test environment with mock users and simulated payments. No real money moves.Planned
- v1.1JavaScript and Python SDKsOfficial client libraries, with TypeScript types.Planned
- v1.1PHP and Flutter SDKsLaravel-friendly PHP and Dart packages for backend and mobile developers.Planned
- v1.1Interactive docsAn OpenAPI spec and documentation you can try requests from.Planned
- v1.2Analytics and batch operationsDeeper campaign reporting, and bulk campaign updates and payouts in one call.Planned
Waitlist
Be first to build with GOB.
Leave your email and we’ll let you know the moment early access opens.
- Early access to the sandbox and API keys
- Priority help from our developer team
- One email when it’s ready. No spam.
We haven’t set a date yet. Join the waitlist and we’ll email you as soon as early access opens.
Probably. Everything on this page is a preview of what we plan to ship. Names, fields and paths may change before launch, and the documentation at launch will be the source of truth.
Not through a public API yet. If you’re a brand or agency, you can already run task campaigns in the GOB app, and our Partnership page covers larger partnerships. Email [email protected] if you’d like to talk.