Register an institution
Registers one of the tenant’s financial institutions: one regulatory declarant, one CNPJ, numeric or alphanumeric. The CNPJ is stored uppercase and without punctuation, and a second live institution with the same CNPJ is refused with 409. Each data source named in the scope must be one the tenant can read; its tables and columns are not checked here. The answer carries the version in the ETag.
Authorizations
JWT bearer token issued by the identity provider.
Body
JSON request payload.
CNPJ of the institution, numeric or alphanumeric, with or without punctuation.
"12.ABC.345/01DE-35"
Name of the institution.
"Banco Exemplo S.A."
The rows of each data source that belong to this institution, keyed by data source name. May be empty.
Response
Created
CNPJ of the institution, uppercase and without punctuation; numeric or alphanumeric.
"12ABC34501DE35"
Creation timestamp in UTC.
"2026-01-01T00:00:00Z"
Unique institution identifier.
"00000000-0000-0000-0000-000000000000"
Name of the institution.
"Banco Exemplo S.A."
The rows of each data source that belong to this institution.
Most recent update timestamp in UTC.
"2026-01-01T00:00:00Z"
Version of the institution; an update presents it as If-Match.
1

