Skip to main content
POST
Trigger SPV sync

Overview

Triggers a synchronous SPV pull for the authenticated firm: fetches messages from ANAF, downloads any missing XMLs, and imports received invoices. The call blocks until ANAF responds — typically 5–30 seconds, occasionally more.

Concurrency

A per-firm file lock prevents concurrent syncs. If a sync is already running for the same firm the endpoint returns HTTP 429 with code: "sync_in_progress" and a Retry-After header.

Choosing the window

Pass days (1–60) to fetch a fixed window. When omitted, Contazen picks the window automatically based on the time since the last successful sync (1 → 60 days).

Authorizations

Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Body

application/json
days
integer

How far back to fetch (1–60). When omitted, the window is chosen automatically based on the time since the last sync.

Required range: 1 <= x <= 60

Response

Sync result

success
boolean
data
object
meta
object