Saltar al contenido principal
POST
Close a reference month into an immutable report

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string
requerido

REQUIRED. Client-supplied replay key, at most 64 bytes. A request without it is refused with PIX-0030 @ 400 before the handler runs. An identical resend within 1 hour returns the original response, status included, with X-Idempotency-Replayed: true. Reusing the key with a divergent method, URL or body is PIX-0031 @ 412.

Required string length: 1 - 64

Cuerpo

application/json
period
string
requerido

Reference month, YYYY-MM. Absent is 400 PIX-0002; not YYYY-MM, or a month before 2020-11, when Pix started, is 400 PIX-0003.

Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])$
Ejemplo:

"2026-10"

Respuesta

OK

blocks
object
requerido

The ten APIX001 blocks in layout order, each with explicit coverage.

ispb
string
requerido

ISPB of the participant the report is for.

Ejemplo:

"12345678"

layoutVersion
string
requerido

APIX001 layout version the blocks follow.

Ejemplo:

"2.7"

period
string
requerido

Reference month, YYYY-MM.

Ejemplo:

"2026-10"

reportId
string
requerido

Immutable identifier of this report; a reopen and a new close produce another.

Ejemplo:

"0193a6f0-7c1e-7b4a-9d2e-5f6a7b8c9d0e"