Invoice API South Africa

Rebill API for
Developer Integration

Create invoices, manage clients, and trigger payments programmatically via a clean REST API. Built for South African businesses that need invoicing integrated directly into their systems.

Get started free Read the docs

POST /v1/invoices

// Create an invoice via the Rebill API
fetch('https://api.rebill.co.za/v1/invoices', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    client_id: 'cli_abc123',
    currency: 'ZAR',
    items: [{ description: 'Web design', amount: 850000 }],
    due_date: '2026-04-30'
  })
})

REST API with JSON - simple to integrate

The Rebill API follows REST conventions using standard HTTP methods and JSON payloads. Authentication is via a Bearer token API key. Amounts are always expressed in cents (e.g. R850.00 = 85000) to avoid floating-point precision issues. Any language or framework that can make HTTP requests can integrate with Rebill.

REST API with JSON request and response bodies
Bearer token authentication via API key
Amounts in cents for precision (ZAR, USD, NGN supported)
Consistent error response format with descriptive messages

Response - 201 Created

{
  "id": "inv_8fkx92nq",
  "number": "INV-0051",
  "status": "draft",
  "currency": "ZAR",
  "amount": 977500,
  "amount_due": 977500,
  "vat_amount": 127500,
  "due_date": "2026-04-30",
  "pdf_url": "https://...",
  "created_at": "2026-03-21T10:00:00Z"
}

POST /v1/invoices Create a new invoice

GET /v1/invoices/:id Retrieve an invoice

POST /v1/invoices/:id/send Send invoice to client

POST /v1/clients Create or update a client

GET /v1/clients List all clients

POST /v1/invoices/:id/payment Initiate payment flow

Create invoices, manage clients, trigger payments

The full invoicing workflow is available via the API. Create clients, create invoices with line items and VAT, send them via email or WhatsApp, and initiate payment links - all without a human touching the Rebill UI. Ideal for e-commerce order invoicing, subscription billing systems, or any workflow where invoices need to be generated automatically.

Create invoices with full line item detail and VAT
Create and update client records programmatically
Send invoices via email or WhatsApp via API
Initiate Paystack, Yoco, or PayFast payment links

Read invoice status and retrieve data

Fetch invoice details, check payment status, and list clients or invoices from your own system. Poll for status updates after initiating a payment flow, or pull invoice data into your own reporting and reconciliation tools.

Retrieve any invoice by ID including current status
List invoices filtered by client, status, or date
Check whether a payment was completed
Pull client records and outstanding balances

GET /v1/invoices/inv_8fkx92nq 200 OK

{
  "id": "inv_8fkx92nq",
  "number": "INV-0051",
  "status": "paid",
  "currency": "ZAR",
  "amount": 977500,
  "amount_due": 0,
  "paid_date": "2026-03-21",
  "client_id": "cli_abc123"
}

Quick answer

What is the Rebill API?

The Rebill API is a REST API that lets developers create and send invoices, manage client records, and trigger payment flows programmatically from any application or system. It uses JSON for data exchange and authenticates via an API key, making it straightforward to integrate with any language or framework.

Common use cases for the Rebill API in South Africa include e-commerce platforms that need to auto-generate a SARS-compliant tax invoice on each order, field service businesses with custom job management software that push invoices to Rebill on job completion, and accounting or ERP systems that synchronise billing data. The API handles South African specifics natively: ZAR amounts in cents, 15% SARS VAT calculations, and integration with Paystack, Yoco, and PayFast for payment collection. Your system can poll invoice status to confirm payment, retrieve client records, and pull invoice data into your own reporting tools. API access is available on the Rebill Premium plan.

Frequently asked questions

What can I do with the Rebill API?

The Rebill API lets you create, update, and send invoices programmatically, manage clients, trigger payment flows, and query invoice status. It is designed for developers building e-commerce platforms, custom business systems, or ERP integrations that need to generate invoices automatically.

How do I get a Rebill API key?

API keys are available from your Rebill account settings. You can generate a key with read-write access for your integration. Keep your API key secure - treat it like a password and never expose it in client-side code or public repositories.

Is the API included in the free plan?

API access is available on the Rebill Premium plan (R99/month). The Premium plan removes limits on invoices, clients, and integrations, making it the right choice for businesses building automated invoicing workflows.

Can I check invoice payment status via the API?

Yes. You can retrieve any invoice by ID and check its current status - draft, sent, paid, or cancelled. Poll the invoice endpoint after initiating a payment flow to confirm whether payment has been completed.

What format does the Rebill API use?

The Rebill API is a REST API using JSON for request and response bodies. Authentication is via Bearer token using your API key. Standard HTTP methods are used: GET to retrieve resources, POST to create them, PUT/PATCH to update, and DELETE to remove. All amounts are in cents to avoid floating-point errors.

Build invoicing into your South African application.

The Rebill API handles ZAR, VAT at 15%, and South African payment gateways out of the box. Start building today with a free account.

Get started free Read the API docs

Rebill API for Developer Integration