Resolve a CID at BACEN
curl --request GET \
--url https://api.example.com/api/v1/dict/cids/entries/{cid} \
--header 'Authorization: Bearer <token>' \
--header 'X-ISPB: <x-ispb>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/dict/cids/entries/{cid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-ISPB", "<x-ispb>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}const options = {
method: 'GET',
headers: {'X-ISPB': '<x-ispb>', Authorization: 'Bearer <token>'}
};
fetch('https://api.example.com/api/v1/dict/cids/entries/{cid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/dict/cids/entries/{cid}"
headers = {
"X-ISPB": "<x-ispb>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"cid": "28c06eb41c4dc9c3ae114831efcac7446c8747777fca8b145ecd31ff8480ae88",
"entry": {
"account": {
"accountNumber": "0007654321",
"accountType": "CACC",
"participant": "12345678",
"branch": "0001",
"openingDate": "2020-01-15T00:00:00Z"
},
"key": "11122233396",
"keyType": "CPF",
"owner": {
"name": "Maria Souza",
"taxIdNumber": "11122233396",
"type": "NATURAL_PERSON",
"tradeName": "Souza Comercio"
},
"creationDate": "2025-03-07T14:30:00.000Z",
"keyOwnershipDate": "2025-03-07T14:30:00.000Z"
},
"requestId": "4b6c1e0e-7f7a-4c1e-9d59-3f2a8c1b5e21",
"bacen": {
"correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"lastModified": "2026-06-14T12:00:00Z",
"responseTime": "2026-06-14T12:00:00Z"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}Resolve a CID at BACEN
Reads the key binding a CID identifies from BACEN’s getEntryByCid, sent with X-ISPB as PI-RequestingParticipant, and projects it verbatim. A CID BACEN no longer binds answers 404 SPI-0012.
GET
/
api
/
v1
/
dict
/
cids
/
entries
/
{cid}
Resolve a CID at BACEN
curl --request GET \
--url https://api.example.com/api/v1/dict/cids/entries/{cid} \
--header 'Authorization: Bearer <token>' \
--header 'X-ISPB: <x-ispb>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/dict/cids/entries/{cid}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-ISPB", "<x-ispb>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}const options = {
method: 'GET',
headers: {'X-ISPB': '<x-ispb>', Authorization: 'Bearer <token>'}
};
fetch('https://api.example.com/api/v1/dict/cids/entries/{cid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/dict/cids/entries/{cid}"
headers = {
"X-ISPB": "<x-ispb>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"cid": "28c06eb41c4dc9c3ae114831efcac7446c8747777fca8b145ecd31ff8480ae88",
"entry": {
"account": {
"accountNumber": "0007654321",
"accountType": "CACC",
"participant": "12345678",
"branch": "0001",
"openingDate": "2020-01-15T00:00:00Z"
},
"key": "11122233396",
"keyType": "CPF",
"owner": {
"name": "Maria Souza",
"taxIdNumber": "11122233396",
"type": "NATURAL_PERSON",
"tradeName": "Souza Comercio"
},
"creationDate": "2025-03-07T14:30:00.000Z",
"keyOwnershipDate": "2025-03-07T14:30:00.000Z"
},
"requestId": "4b6c1e0e-7f7a-4c1e-9d59-3f2a8c1b5e21",
"bacen": {
"correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
"lastModified": "2026-06-14T12:00:00Z",
"responseTime": "2026-06-14T12:00:00Z"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}{
"correlationId": "req-7a3f9c2e",
"code": "<string>",
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example",
"upstream": {
"code": "E4001",
"message": "account not found at provider"
}
}Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
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}$Ejemplo:
"12345678"
Parámetros de ruta
CID to resolve, 64 hex characters.
Pattern:
^[0-9a-fA-F]{64}$Ejemplo:
"28c06eb41c4dc9c3ae114831efcac7446c8747777fca8b145ecd31ff8480ae88"
Respuesta
OK
The CID that was resolved.
Ejemplo:
"28c06eb41c4dc9c3ae114831efcac7446c8747777fca8b145ecd31ff8480ae88"
The key binding the CID identifies.
Show child attributes
Show child attributes
BACEN's RequestId of the operation that created this binding, from which the CID was computed. Not a request-scoped echo.
Ejemplo:
"4b6c1e0e-7f7a-4c1e-9d59-3f2a8c1b5e21"
BACEN's operational envelope for this call; omitted when BACEN sent no correlation id.
Show child attributes
Show child attributes
¿Esta página le ayudó?