Flireo AI
WebsiteLinkedin
WebsiteLinkedin
  1. Guides
  • API Reference
    • Agents
      • List all agents
      • Create a new agent
      • Get an agent
      • Update an agent
      • Delete an agent
    • Tool Templates
      • List all tool templates
      • Create a new tool template
      • Get a tool template
      • Update a tool template
      • Delete a tool template
    • Numbers
      • List all phone numbers
      • Register a phone number
      • Get a phone number
      • Update a phone number
      • Delete a phone number
    • Calls
      • List calls
      • Get call by ID
      • Initiate outbound call
    • Call Control
      • Send control command to active call
    • Usage
      • Get usage logs
    • SIP Trunks
      • List SIP trunks
      • Create a SIP trunk
      • Get a SIP trunk
      • Delete a SIP trunk
    • Voices
      • List available voices
    • BYOK
      • Get BYOK configurations
      • Add BYOK configuration
      • Delete BYOK configuration
      • Get BYOK provider configurations
    • Domains
      • Get your domain
      • Add a domain
      • Delete your domain
      • List available Resend domains
      • Select and sync a Resend domain
      • Verify domain DNS records
      • Refresh domain status
    • Webhooks
      • Dynamic assistant configuration webhook
      • Tool/Function Call
      • Call Status Update
      • End of Call Report
    • Analysis Templates
      • List analysis templates
      • Create analysis template
      • Get analysis template
      • Update analysis template
      • Delete analysis template
    • Organization
      • Get organization information
    • Campaigns
      • List all campaigns
      • Create a campaign
      • Get a campaign
      • Update a campaign
      • Delete a campaign
      • List campaign leads
      • Add a lead
      • Remove a lead
  • Documentation
    • Get started
      • Quickstart
      • Introduction
      • Authentication
    • Core concepts
      • Agents
      • Phone numbers
      • Calls
      • Webhooks
    • Api's
      • Organization
      • Agents
      • Phone numbers
      • Sip trunks
      • Calls
      • Call control
      • Usage
      • Voices
      • BYOK
      • Domains
      • Analysis templates
      • Tool templates
    • Webhooks
      • Overview
      • Assistant request
      • Tool calls
      • Status update
      • End of call report
      • Security
    • Guides
      • BYOK Setup
      • Call analysis
      • Custom Tools
      • Call Transfers
      • xAI Realtime Integration
      • Analysis templates
      • Billing
      • Error codes
      • Rate limits
      • Sip Trunks
      • Tool templates
      • Troubleshooting
WebsiteLinkedin
WebsiteLinkedin
  1. Guides

Billing

Flireo uses a credits-based billing system. You purchase credits upfront and they are consumed as you make and receive calls.

Pricing#

ResourceCost
Voice call minutes€0.07 per minute

How Credits Work#

1.
Purchase credits - Add credits to your account via the dashboard
2.
Use credits - Credits are consumed based on call duration
3.
Track usage - Monitor your balance and usage in real-time

Credit Balance#

Check your current balance via the API:
Response:
{
  "id": "org-uuid",
  "company_name": "Your Company",
  "minutes_balance": 500,
  "monthly_usage_minutes": 120
}
FieldDescription
minutes_balanceAvailable credit minutes
monthly_usage_minutesMinutes used this month

Usage Tracking#

View detailed usage logs:
Response:
{
  "usage": [
    {
      "id": "usage-uuid",
      "duration_sec": 84,
      "created_at": "2025-12-13T10:00:00.000Z",
      "number_id": "number-uuid"
    }
  ],
  "summary": {
    "total_seconds": 7200,
    "total_minutes": 120,
    "total_cost": 8.40
  }
}

Insufficient Credits#

When your balance reaches zero:
Inbound calls: An error audio message is played to the caller and the call is logged as status: rejected.
Outbound calls: The API returns 402 Payment Required:
{
  "error": {
    "code": "insufficient_credits",
    "message": "Insufficient credits to make outbound call. Please add credits in your billing dashboard."
  }
}

Adding Credits#

Credits can be added through the dashboard:
1.
Navigate to Settings > Billing
2.
Click Add Credits
3.
Select the amount
4.
Complete payment
Payment methods accepted:
Credit card (Visa, Mastercard, American Express)

Invoices#

All credit purchases generate an invoice with:
Invoice number
Purchase amount
VAT (if applicable, based on your location)
PDF download
Access invoices in Settings > Billing > Invoices.

Tax Information#

For EU businesses:
If you provide a valid VAT ID, reverse charge applies (0% VAT)
Without VAT ID, destination country VAT rate applies
To add billing information:
1.
Go to Settings > Billing
2.
Add your company name, address, and VAT ID
3.
Information is synced to Stripe for invoice generation

Low Balance Notifications#

Set up a webhook to monitor your balance and receive alerts:

BYOK Cost Considerations#

When using BYOK (Bring Your Own Key):
You pay Flireo €0.07/minute for platform usage
You pay providers directly for their API usage
Provider costs vary based on your plan and usage
This gives you:
Full control over provider costs
Access to your provider's features and models
Separate billing for transparency

Related#

Usage API
Account API
BYOK Setup
Modified at 2025-12-31 12:08:10
Previous
Analysis templates
Next
Error codes
Built with