Skip to main content
POST
Request a CID set file from BACEN

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency
string
required

Required key used to prevent replaying the mutation.

X-ISPB
string
required

ISPB of the participant the call acts for. It must be this deployment's direct participant or an indirect it sponsors; the body never carries it.

Pattern: ^[0-9A-Z]{8}$
Example:

"12345678"

Body

application/json
keyType
enum<string>
required

Key type whose CID set file BACEN builds.

Available options:
CPF,
CNPJ,
EMAIL,
PHONE,
EVP
Example:

"EMAIL"

Response

Created

id
string
required

BACEN's id for the file; read it with GET cids/files/{id}.

Example:

"4521"

keyType
string
required

Key type of the CID set.

Example:

"EMAIL"

participant
string
required

ISPB whose CID set the file holds.

Example:

"12345678"

requestTime
string
required

When BACEN received the request, BACEN's wire value.

Example:

"2026-09-29T12:00:00.123Z"

status
string
required

BACEN's file status, verbatim: REQUESTED, PROCESSING, AVAILABLE, UNAVAILABLE or ERROR.

Example:

"REQUESTED"

bacen
object

BACEN's operational envelope for this call; omitted when BACEN sent no correlation id.