Search the evidence trail

curl --request POST \
  --url https://api.example.com/v1/src/evidence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "consultationId": "0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a",
  "controlCode": "<string>",
  "cursor": "<string>",
  "document": "<string>",
  "from": "2026-08-01T00:00:00Z",
  "limit": 50,
  "to": "2026-08-31T23:59:59Z"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/src/evidence"

	payload := strings.NewReader("{\n  \"consultationId\": \"0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a\",\n  \"controlCode\": \"<string>\",\n  \"cursor\": \"<string>\",\n  \"document\": \"<string>\",\n  \"from\": \"2026-08-01T00:00:00Z\",\n  \"limit\": 50,\n  \"to\": \"2026-08-31T23:59:59Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    consultationId: '0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a',
    controlCode: '<string>',
    cursor: '<string>',
    document: '<string>',
    from: '2026-08-01T00:00:00Z',
    limit: 50,
    to: '2026-08-31T23:59:59Z'
  })
};

fetch('https://api.example.com/v1/src/evidence', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/src/evidence"

payload = {
    "consultationId": "0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a",
    "controlCode": "<string>",
    "cursor": "<string>",
    "document": "<string>",
    "from": "2026-08-01T00:00:00Z",
    "limit": 50,
    "to": "2026-08-31T23:59:59Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "items": [
    {
      "acceptedAt": "2023-11-07T05:31:56Z",
      "bcbControlCode": "<string>",
      "concludedAt": "2023-11-07T05:31:56Z",
      "consultationId": "0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a",
      "documentMasked": "529******25",
      "status": "completed"
    }
  ],
  "limit": 50,
  "nextCursor": "<string>",
  "prevCursor": "<string>"
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

POST

src

evidence

Search the evidence trail

curl --request POST \
  --url https://api.example.com/v1/src/evidence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "consultationId": "0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a",
  "controlCode": "<string>",
  "cursor": "<string>",
  "document": "<string>",
  "from": "2026-08-01T00:00:00Z",
  "limit": 50,
  "to": "2026-08-31T23:59:59Z"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/src/evidence"

	payload := strings.NewReader("{\n  \"consultationId\": \"0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a\",\n  \"controlCode\": \"<string>\",\n  \"cursor\": \"<string>\",\n  \"document\": \"<string>\",\n  \"from\": \"2026-08-01T00:00:00Z\",\n  \"limit\": 50,\n  \"to\": \"2026-08-31T23:59:59Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    consultationId: '0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a',
    controlCode: '<string>',
    cursor: '<string>',
    document: '<string>',
    from: '2026-08-01T00:00:00Z',
    limit: 50,
    to: '2026-08-31T23:59:59Z'
  })
};

fetch('https://api.example.com/v1/src/evidence', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/src/evidence"

payload = {
    "consultationId": "0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a",
    "controlCode": "<string>",
    "cursor": "<string>",
    "document": "<string>",
    "from": "2026-08-01T00:00:00Z",
    "limit": 50,
    "to": "2026-08-31T23:59:59Z"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "items": [
    {
      "acceptedAt": "2023-11-07T05:31:56Z",
      "bcbControlCode": "<string>",
      "concludedAt": "2023-11-07T05:31:56Z",
      "consultationId": "0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a",
      "documentMasked": "529******25",
      "status": "completed"
    }
  ],
  "limit": 50,
  "nextCursor": "<string>",
  "prevCursor": "<string>"
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

{
  "correlationId": "req-7a3f9c2e",
  "detail": "check digits are invalid for the declared documentType",
  "instance": "/v1/src/consultations",
  "status": 400,
  "title": "Bad Request",
  "traceId": "a1b2c3d4",
  "type": "<string>",
  "violations": [
    {
      "field": "document",
      "reason": "check digits are invalid for the declared documentType",
      "code": "<string>"
    }
  ],
  "code": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

X-Request-ID

string

Optional correlation id (UUID) propagated through logs/traces.

Body

application/json

consultationId

string

Filter by one consultation (UUID). A non-UUID returns 422 SRC-0002.

Example:

"0192f5c4-1c2f-7c3a-8a1b-9f2e3d4c5b6a"

controlCode

string

Filter by the consultation control code assigned by BACEN (NumCtrlSRC).

Maximum string length: 64

cursor

string

Opaque pagination cursor from a previous page. An invalid cursor returns 400 SRC-0001.

document

string

Filter by consulted document, unmasked: CPF (11 numeric digits) or CNPJ (14 characters, 12 alphanumeric [0-9A-Z] plus 2 numeric check digits).

Pattern: ^([0-9]{11}|[0-9A-Z]{12}[0-9]{2})$

from

string

Inclusive lower bound on acceptance time (RFC3339 date-time). Unparseable returns 400 SRC-0001.

Example:

"2026-08-01T00:00:00Z"

limit

integer<int64>

default:50

Page size (1..200).

Required range: 1 <= x <= 200

Example:

50

string

Inclusive upper bound on acceptance time (RFC3339 date-time). Unparseable returns 400 SRC-0001; earlier than from returns 422 SRC-0002.

Example:

"2026-08-31T23:59:59Z"

Response

items

object[] | null

required

The page's consultation projections, most recently accepted first.

Show child attributes

limit

integer<int64>

required

Effective page size this request was served with.

Example:

50

nextCursor

string | null

required

Opaque cursor for the following page; null on the last page.

prevCursor

string | null

required

Opaque cursor for the preceding page; null (backwards paging is served by neither cursor endpoint of this service).

Consultations

Institution records

Evidence

Dashboard

Credentials

Operator cases

Error handling

Search the evidence trail

Authorizations

Headers

Body

Response