Rate Limits

Check Your Rate Limits

Your API access is determined by your Sona pricing plan. To check your API usage and remaining credits, visit the Billing Overview page in your account settings.

Sona uses a credit-based system for API calls. Each API endpoint consumes credits based on the type of data enrichment performed. The number of credits available depends on your subscription tier, with higher plans offering more credits and advanced features.

Understanding Sona Credits

Sona credits are consumed for the following operations:

• Person-level identification - Revealing contact details for website visitors
• Company-level identification - Identifying companies visiting your website
• Email prospecting - Finding and verifying business email addresses
• Data enrichment - Enriching profiles with firmographic and demographic data

info

If you have existing subscriptions to data enrichment tools (such as Apollo), you can connect your own API keys through Connectors at no cost. This allows you to use those services without consuming Sona credits.

Credit Rollover

Monthly subscribers can roll over unused credits to the next month. However, the total saved credits cannot exceed twice the monthly credit limit of your plan.

warning

After canceling or downgrading your subscription, your credits will remain in your account until the end of your current billing cycle.

Monitoring Your Usage

You can track your credit usage in real-time through the Billing Overview page, which displays:

• Credits Used - Total credits consumed in the current billing period
• Credits Remaining - Available credits for the rest of the billing cycle
• Monthly Tracked Users - Number of unique users tracked
• People Identified - Total contacts revealed
• Companies Identified - Total companies identified
• Emails Revealed - Total email addresses discovered

API Request Limits

In addition to credit-based limits, the Sona API enforces the following technical rate limits to ensure system stability:

• Maximum requests per minute: Contact your account manager for specific limits
• Concurrent request limit: Contact your account manager for specific limits

If you exceed these limits, the API will return a 429 Too Many Requests response. Implement exponential backoff in your application to handle rate limit errors gracefully.

Best Practices

To use the Sona API efficiently:

1. Cache data locally - Store frequently accessed data that doesn't change often
2. Batch requests - Use bulk endpoints when available (e.g., Bulk Profile360, Bulk Company Enrichment)
3. Implement retry logic - Handle rate limit errors with exponential backoff
4. Monitor your usage - Regularly check your credit consumption to avoid interruptions
5. Use your own API keys - Connect existing data provider subscriptions to avoid consuming Sona credits

Need Higher Limits?

If your use case requires higher rate limits or additional credits, please contact our sales team to discuss custom enterprise plans.