Billing

FirstHandAPI uses a pre-funded credit model. Credits are consumed when submissions are approved.

Get Credit Balance

GET /v1/billing/credits

Returns current credit balance, pending holds, and auto-top-up status.

GET /v1/billing/transactions

Returns credit transaction history (deposits, payouts to workers, refunds, expirations).

Query Parameters:

Param	Type	Description
`type`	string	Filter: `deposit`, `payout`, `refund`, `expiration`
`limit`	integer	Max results (1-100, default 20)
`cursor`	string	Pagination cursor

POST /v1/billing/credits/purchase

Initiates a credit purchase via Stripe Checkout.

Field	Type	Required	Description
`amount_cents`	integer	yes	Purchase amount in cents

Response: Returns a checkout_url to redirect the user to Stripe.

Buyers set the price per file when creating a job. The platform split is:

Recipient	Share
Worker	80% of price per file
FirstHandAPI	20% of price per file

There are no additional platform fees. You pay only for approved files.