Credit System

Pricing, cost estimation, and balance checking.

Pricing

Document Generation

Output	Cost Per Document
Typed PDF	`20 + ceil(max(fields - 25, 0) / 25) * 2`
Handwritten PDF	`40 + ceil(max(fields - 25, 0) / 25) * 4`
CSV or JSON only	`3`
PDF + CSV/JSON	PDF price (CSV/JSON included free)

Tabular Generation

Base rate: 1 credit per 50 rows. Column surcharge: 1 credit per 500 extra cells when columns > 10 (extra cells = rows × (columns − 10)). Formula: ceil(rows/50 + ceil(rows × max(cols−10, 0) / 500)).

Raw Identities

Free — the POST /identities endpoint charges no credits.

Examples

What	Fields	Quantity	Formats	Credits
W-2	20	100	pdf_typed	2,000
W-2	20	100	csv	300
W-2	20	100	pdf_typed, csv	2,000
1040	50	100	pdf_typed	2,200
Tabular	5	1,000	csv	20
Identities	—	1,000	json	0 (free)

Checking Balance

curl https://symagedocs.ai/api/v1/account/balance \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

{{
  "data": {{
    "credits_used": 15000,
    "credits_allocated": 18000
  }}
}}

Cost Estimation

Look up a form's credit_cost field before creating a job:

curl https://symagedocs.ai/api/v1/forms/irs_w2_2025 \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Multiply credit_cost by your quantity for the total.