Credits

Braidis uses a weighted credit system. Every lookup consumes credits from your monthly allocation. Different data types cost different amounts based on complexity.

Credit Costs

Lookup Type	Credits	What You Get
Phone Validation	1	Verify if a number is real and active
Caller ID	2	Phone → name
Property Owner	3	Address → owner name
Phone Append	3	Name + address → phone number
Reverse Phone	5	Phone → name + address
Full Property	8	Address → owner + phone + email
Full Identity	15	Any fragment → complete verified profile

Checking Your Balance

Every API response includes your remaining credits:

{
  "success": true,
  "credits_used": 5,
  "credits_remaining": 995,
  "data": { ... }
}

You can also check your balance directly:

curl https://api.braidisdata.com/v1/account/credits \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "credits_allocated": 5000,
  "credits_used": 1247,
  "credits_remaining": 3753,
  "rollover_credits": 250,
  "billing_cycle_end": "2026-04-01T00:00:00Z"
}

Caching

Repeat lookups on the same record within the cache window cost 0 credits. Cache durations vary by data type:

Data Type	Cache Duration
Property ownership	6-12 months
Phone numbers	2-3 months
Demographics	12 months

Overages

Paid plans use soft overages — your lookups never stop working. Overages are charged at a small premium per credit on your next invoice. You'll receive notifications at 80%, 100%, and 120% of your monthly allocation.

Rollover

SMB and above plans roll over 25% of unused credits to the next month (capped at 25% of your monthly allocation).

Example: Growth plan with 5,000 credits/month. You use 4,000. 25% of the 1,000 unused = 250 credits roll over. Next month starts at 5,250.