View Categories

Your First API Call

1 min read

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 #

  1. Log in to app.voxpria.com
  2. Navigate to Settings → API Keys
  3. Click “Create New API Key”
  4. Give it a name (e.g., “My First API Key”)
  5. Select scopes: calls:read and calls:write
  6. 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 #

🎮 Launch Playground

Next Steps #

  • Authentication – Learn about API security
  • API ReferenceExplore all endpoints
  • Code Examples – See examples in your language

Leave A Comment

Go to Top