Table of Contents
Making Your First API Call #
Welcome to VoxPria’s REST API! This guide will walk you through making your first API call in just a few minutes.
What You’ll Need #
- A VoxPria account (sign up here)
- An API key (we’ll show you how to create one)
- A tool to make HTTP requests (curl, Postman, or your favorite programming language)
Quick Start in 3 Steps #
Step 1: Get Your API Key #
- Log in to app.voxpria.com
- Navigate to Settings → API Keys
- Click “Create New API Key”
- Give it a name (e.g., “My First API Key”)
- Select scopes:
calls:readandcalls:write - Copy your API key immediately!
⚠️ Important: Store your API key securely! Never share it or commit to Git.
Step 2: Make Your First API Call #
Get your credit balance using curl:
curl -X GET "https://app.voxpria.com/api/v1/credits" \ -H "Authorization: Bearer YOUR_API_KEY_HERE" \ -H "Content-Type: application/json"
Step 3: Understand the Response #
{
"success": true,
"data": {
"balance": 1500,
"currency": "credits"
}
}
Response Codes #
| Code | Meaning | Action |
|---|---|---|
200 |
Success | ✅ Working! |
401 |
Unauthorized | Check API key |
403 |
Forbidden | Check scopes |
429 |
Rate Limited | Slow down |
Try the API Playground #
Next Steps #
- Authentication – Learn about API security
- API Reference – Explore all endpoints
- Code Examples – See examples in your language

Leave A Comment