InvoiceDirect API Reference

InvoiceDirect by Gemspay exposes REST APIs for four kinds of integrations into the FIRS e-Invoicing ecosystem. Pick the surface that matches how you're integrating:

• Taxpayer API — create, retrieve, and manage your own invoices (list, create, bulk create, update status/payment, exchange supplier invoices).
• System Integrator API — for ERP/accounting software vendors onboarding and managing multiple taxpayers on their behalf, and generating Invoice Reference Numbers (IRNs).
• Core API — look up FIRS reference data such as currencies, tax categories, product/service codes, states, and countries.
• Access Point Provider API — validate, submit, transmit, and report invoices directly to FIRS, and receive webhook notifications.

Base URL

https://invoice-direct.gemspaysolution.com/api

Every endpoint documented here is relative to this base URL, e.g. /v1/tax-payers/invoices resolves to https://invoice-direct.gemspaysolution.com/api/v1/tax-payers/invoices.