v0.5 — Now in public beta

The commerce API
built for Africa

Build storefronts, inventory and order solutions, useful tools for businesses; to reach thousands of businesses on Bumpa across Nigeria and Kenya.

Get your API key →Read the docs
$curl -X GET https://api.bumpa.io/v1/products \

API Capabilities

The full stack for
African commerce

One unified API surface covers every layer of the commerce stack. Start with what you need, expand as you grow.

Storefronts

Launch branded online stores in minutes. Full control over product catalogs, themes, and custom domains — all served from our globally distributed CDN.

GET /v1/storesPOST /v1/storesGET /v1/products

Inventory

Real-time stock tracking across multiple locations and warehouses. Automatic deductions on every sale, low-stock alerts, and barcode generation built in.

GET /v1/inventoryPATCH /v1/inventory/:idPOST /v1/locations

Orders

End-to-end order lifecycle management. From creation and payment status to fulfilment, shipping, and automated customer notifications via SMS and email.

POST /v1/ordersGET /v1/orders/:idPATCH /v1/orders/:id/status

Customers

Full CRM capabilities — customer records, purchase history, segmentation, and bulk messaging. Connect Instagram DM and WhatsApp to capture leads automatically.

GET /v1/customersPOST /v1/customersGET /v1/customers/:id/orders

Analytics

Profit reports, best-selling products, average customer spend, and sales trends — all surfaced in real time across every channel and location.

GET /v1/analytics/salesGET /v1/analytics/productsGET /v1/analytics/customers

Webhooks

Subscribe to real-time events — order.created, payment.received, inventory.low, customer.created — and keep every system in sync without polling.

POST /v1/webhooksGET /v1/webhooksDELETE /v1/webhooks/:id
100,000+
Active businesses
99.9%
API uptime SLA
<120ms
Median latency
5+
Currencies supported

Developer Experience

Simple, predictable
REST APIs

Consistent JSON responses, standard Laravel pagination, and comprehensive docs so you can integrate in hours, not weeks.

GET/api/v0.5/products
Request
curl -X GET "https://api.getbumpa.com/api/v0.5/products?page=1&limit=10&sort_direction=desc" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json"
200 OK
Response
{
  "location_id": 4005,
  "products": {
    "current_page": 1,
    "data": [
      {
        "id": 1067470,
        "title": "Dainty Dress",
        "description": "A flare dress with a pop of colors, perfect for every occasion.",
        "sku": null,
        "type": "simple",
        "status": true,
        "price": "23500.00",
        "quantity": "14"
      },
      {
        "id": 1061340,
        "title": "Alliyah Dress",
        "description": "A flare dress with a V neck and puffy sleeves.",
        "sku": "ALY-001",
        "type": "simple",
        "status": true,
        "price": "10500.00",
        "quantity": "8"
      }
    ],
    "per_page": 10,
    "total": 41,
    "current_page": 1,
    "last_page": 5,
    "next_page_url": "https://api.getbumpa.com/api/v0.5/products?page=2"
  }
}

Full API reference on docs.bumpa.io

Base URL: https://api.getbumpa.com · Auth: Bearer token · Version: v0.5

Explore API reference →
In Testing — Early Access

Bumpa MCP

AI agents with real
merchant context

The Bumpa MCP server connects AI assistants directly to a merchant's store data — powered by Bumpa OAuth so business owners stay in full control of what they share.

How OAuth powers the MCP

Merchant authorizes

Business owner grants consent via Bumpa OAuth, choosing exactly which data to share.

Token issued

An OAuth access token is issued scoped to the approved permissions — no over-sharing.

MCP tools activate

The AI agent calls MCP tools using the token. No API key management — the merchant stays in control.

Agent acts

Query data, run internal commands, or execute autonomous tasks — all with merchant consent.

Live tools

describe-bumpaContext

Platform context the model needs before acting on any merchant data.

list-productsRead

Products with price, stock, SKU, and status — paginated and filterable.

list-ordersRead

Orders with customer, payment, and shipping detail. Filter by location or status.

list-notificationsRead

Unread business alerts — new orders, milestones, payment confirmations.

Incoming tools

list-customers
ReadSoon
get-analytics
ReadSoon
create-order
WriteSoon
update-product
WriteSoon
list-invoices
ReadSoon
create-payment-link
WriteSoon

Example interaction

Claude + Bumpa MCP
OAuth session
Which of my products are running low this week?
list-products → status=low_stock limit=10
3 items need restocking: Alliyah Dress (2 left), Aso-oke Set (1 left), and Ankara Wrap (0 — sold out). Want me to draft a restock note?

What you can build

AI assistants for merchants

Let any AI tool query a merchant's store data after a one-time OAuth authorization.

Bumpa Extensions

Third-party widgets embedded inside the Bumpa dashboard. OAuth handles authorization so they feel native.

Custom autonomous agents

Business owners can wire up agents for internal commands or automated workflows — reorders, alerts, reports.

Build the future of
African commerce

Start earning from building tools for over 100,000 businesses on Bumpa.

Get your API key →Read the docs