Make the first API request

​

Before starting

• Create a key from API Keys in Mission Control Portal. See Create and manage API keys for storage and rotation guidance.
• Install curl on macOS or Linux, or use PowerShell on Windows.
• Keep the key in a server-side environment variable. Never embed it in browser or mobile code.

​

Send the request

export TELNYX_API_KEY="..."

curl --request GET \
  --url "https://api.telnyx.com/v2/balance" \
  --header "Authorization: Bearer $TELNYX_API_KEY" \
  --header "Accept: application/json"

$Env:TELNYX_API_KEY = "..."

$headers = @{
  Authorization = "Bearer $Env:TELNYX_API_KEY"
  Accept = "application/json"
}

Invoke-RestMethod `
  -Method Get `
  -Uri "https://api.telnyx.com/v2/balance" `
  -Headers $headers

{
  "data": {
    "record_type": "balance",
    "pending": "10.00",
    "balance": "300.00",
    "credit_limit": "100.00",
    "available_credit": "400.00",
    "currency": "USD"
  }
}

​

Interpret failures

• 401 Unauthorized: The Authorization header is absent or the key is invalid.
• 403 Forbidden: The credential or account cannot access balance information.
• 422 Unprocessable Entity: The request reached the endpoint but could not be processed.
• 503 Service Unavailable: The service is temporarily unavailable. Apply the retry guidance.

​

Continue

• Open the balance API reference
• Select a server-side SDK
• Install the Telnyx CLI
• Review request and response handling