Skip to main content
POST
Reopen a closed reference month

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency
string
required

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

Body

application/json
period
string
required

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])$
Example:

"2026-10"

Response

OK

period
string
required

Reference month, YYYY-MM.

Example:

"2026-10"

status
enum<string>
required

OPEN until a close freezes the month; CLOSED while a report is in force.

Available options:
OPEN,
CLOSED
Example:

"OPEN"