VasBox API Documentation

VasBox provides a powerful REST API that enables you to create, manage, and submit fiscal documents to ZIMRA. Our API is designed to be intuitive, well-documented, and compliant with Zimbabwe's fiscal regulations.

To start using the VasBox API, you'll need to obtain API credentials and set up authentication. Follow the steps below to get your first integration running.

InstallationCopy link to section

Install the VasBox SDK for your preferred programming language:

npm install @vasbox/sdk

AuthenticationCopy link to section

The VasBox API uses Bearer token authentication. Include your API key in the Authorization header of every request.

curl -H 'Authorization: Bearer YOUR_API_KEY' \
  https://api.vasbox.co.zw/v1/me

Here's an example of creating an invoice using the VasBox API. This demonstrates the basic structure of API requests.

curl -X POST https://api.vasbox.co.zw/v1/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cust_123",
    "items": [
      {
        "description": "Product A",
        "quantity": 2,
        "unit_price": 1500.00
      }
    ]
  }'

Now that you've made your first API request, explore these resources to learn more: