Postman Collection

Our Postman collection includes pre-configured requests for all VasBox API endpoints, making it easy to explore the API and test your integration.

Import the VasBox collection into Postman:

One-Click ImportCopy link to section

Click the button below to import the collection directly into Postman:

Manual ImportCopy link to section

1. Download the VasBox Postman Collection
2. Open Postman
3. Click Import in the top left
4. Drag the downloaded file or click Upload Files
5. Click Import to confirm

Configure the collection with your API credentials:

Environment SetupCopy link to section

1. Click Environments in the left sidebar
2. Select VasBox Sandbox (imported with collection)
3. Set your API key in the vasbox_api_key variable
4. Click Save
5. Select the environment from the dropdown in the top right

{
  "vasbox_api_key": "vb_test_your_api_key_here",
  "vasbox_base_url": "https://sandbox.api.vasbox.co.zw/v1"
}

The collection is organized by resource type:

Collection StructureCopy link to section

• Invoices - Create, list, get, update, submit, void
• Receipts - Create, list, get, void
• Products - CRUD operations for products
• Customers - CRUD operations for customers
• Webhooks - Webhook management
• Reports - Generate various reports

Running RequestsCopy link to section

1. Expand a folder (e.g., "Invoices")
2. Select a request (e.g., "Create Invoice")
3. Review and modify the request body if needed
4. Click Send
5. View the response in the lower panel

Using VariablesCopy link to section

The collection uses variables for common values. After creating a resource, save its ID as a variable:

1. Create an invoice using "Create Invoice"
2. Copy the id from the response
3. Set it as invoice_id in your environment
4. Other requests will automatically use this ID

The collection includes two pre-configured environments:

Sandbox EnvironmentCopy link to section

Use for development and testing. No real transactions are created.

• Base URL: https://sandbox.api.vasbox.co.zw/v1
• Use test API keys (prefix: vb_test_)

Production EnvironmentCopy link to section

Use for live transactions with real ZIMRA submissions.

• Base URL: https://api.vasbox.co.zw/v1
• Use live API keys (prefix: vb_live_)