Document

Get Extraction Costs

Look up what a batch of extractions cost.

Lean by design: costs only — no signed document URLs, no extracted values. Use this instead of the full extraction view when all you need is spend.

Pass one ids parameter per extraction, e.g. ?ids=<uuid>&ids=<uuid>.

Ids belonging to another API key, and ids that do not exist, are omitted from the response rather than reported — the endpoint cannot be used to discover whether an extraction id is real. Key the response by extractionId; order is not guaranteed.

Each entry carries a state:

  • settled — the charge is on record; the number is final
  • pending — billing has not run yet; retry
  • not_charged — billing finished with no charge; this never resolves
get/api/v1/documents/extractions/costs

Request

  • Base URL: https://api.gemina.co (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemina.co/api/v1/documents/extractions/costs
  • Auth: API key in header X-API-Key

Query parameters

idsstring[] required

Repeat the parameter once per id, e.g. ?ids=<uuid>&ids=<uuid>. Up to 100 per call.

Response

Successful Response

servedAtstring date-time
servedAtTimestampnumber
createdAtstring date-time nullable
createdAtTimestampnumber nullable
status'pending' | 'in_process' | 'failed' | 'success' | 'partial' | 'empty' required
errorsobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.