Get SAT history sync progress

Reports how far the SAT has handed over your invoice history.

The SAT does not deliver a history all at once. It is backfilled forward from your sync start date in month-sized windows, and until that reaches the present, a query for a recent date range succeeds and returns nothing — identical to genuinely having no invoices. This endpoint is how you tell those apart.

Fields:

Field	Meaning
`percent`	How much of the requested history has arrived
`covered_through`	Last date the backfill has reached
`months_remaining`	Roughly how much history is still pending
`current`	History is close enough to the present to be usable
`stalled`	Backfill has not advanced in over two days
`enabled`	Sync is active. When `false` it will not advance on its own
`eta_at`	Projected completion, epoch ms. Omitted while `stalled`, since a stopped sync has no meaningful estimate

Values are refreshed periodically in the background. Pass refresh=true to recompute against the provider, which takes a few seconds.

{ "success": true, "data": { "registered": true, "provider": { "percent": 34.7, "covered_through": "2022-10-13", "months_remaining": 46.5, "current": true, "stalled": true, "enabled": true, "eta_at": 0, "eta_confidence": "observed", "updated_at": 0 }, "stored": { "total": 0 }, "message": "string" } }

Get SAT history sync progress

Request

Responses