List reconciliation logs

curl --request GET \
  --url https://api.example.com/dict-hub/v1/vsync/reconciliation-logs \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/dict-hub/v1/vsync/reconciliation-logs"

	req, _ := http.NewRequest("GET", url, nil)

	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: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/dict-hub/v1/vsync/reconciliation-logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/dict-hub/v1/vsync/reconciliation-logs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "createdAt": "2026-04-20T10:03:15Z",
      "id": "019606b2-4c5d-7e8f-0a12-345678901bcd",
      "keyType": "CPF",
      "outcomeType": "DIFFERENCE_DETECTED",
      "cid": "a1b2c3d4e5f6a7b8",
      "details": {},
      "entryId": "019606c3-5d6e-7f80-1b23-456789012cde",
      "jobId": "019606a1-3b4c-7d8e-9f01-234567890abc"
    }
  ],
  "limit": 10,
  "page": 1,
  "total": 1
}

{
  "code": "PIX-0000",
  "title": "Internal Server Error",
  "message": "The server encountered an unexpected error. Please try again later."
}

{
  "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"
  }
}

List reconciliation logs

Returns a page of reconciliation audit logs, newest first, one row per outcome. Filter by outcome type, key type, job ID and date range. Personal data in the details is masked.

The outcome types are ENTRY_CREATED, ENTRY_DELETED, ORPHAN_DETECTED, DIFFERENCE_DETECTED, ENTRY_NOT_FOUND and VALIDATION_FAILURE. outcome_type is matched as written and is not validated, so a value that is not one of these returns an empty page, not an error.

VALIDATION_FAILURE is the manual-review record. It marks an entry that a reconciliation refused for good and did not apply: an event-feed CID that is not 64 hexadecimal characters or carries an action Pix Lerian does not handle, or a BACEN entry that fails validation, does not produce its CID or belongs to another scope. The reconciliation moves on and nothing applies that entry later, so list outcome_type=VALIDATION_FAILURE to find what needs review. details names the flow (event_sync or file_reconciliation), the reason (invalid_cid, unknown_action or refused_entry) and the error.

Only DIFFERENCE_DETECTED and VALIDATION_FAILURE rows carry details.

GET

vsync

reconciliation-logs

List reconciliation logs

curl --request GET \
  --url https://api.example.com/dict-hub/v1/vsync/reconciliation-logs \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/dict-hub/v1/vsync/reconciliation-logs"

	req, _ := http.NewRequest("GET", url, nil)

	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: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/dict-hub/v1/vsync/reconciliation-logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/dict-hub/v1/vsync/reconciliation-logs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "createdAt": "2026-04-20T10:03:15Z",
      "id": "019606b2-4c5d-7e8f-0a12-345678901bcd",
      "keyType": "CPF",
      "outcomeType": "DIFFERENCE_DETECTED",
      "cid": "a1b2c3d4e5f6a7b8",
      "details": {},
      "entryId": "019606c3-5d6e-7f80-1b23-456789012cde",
      "jobId": "019606a1-3b4c-7d8e-9f01-234567890abc"
    }
  ],
  "limit": 10,
  "page": 1,
  "total": 1
}

{
  "code": "PIX-0000",
  "title": "Internal Server Error",
  "message": "The server encountered an unexpected error. Please try again later."
}

{
  "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

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de consulta

outcome_type

string

Filter by outcome type: ENTRY_CREATED, ENTRY_DELETED, ORPHAN_DETECTED, DIFFERENCE_DETECTED, ENTRY_NOT_FOUND or VALIDATION_FAILURE. Matched as written; an unknown value returns an empty page, not an error

Ejemplo:

"DIFFERENCE_DETECTED"

key_type

string

Filter by key type

Ejemplo:

"CPF"

job_id

string

Filter by job ID (UUID)

Ejemplo:

"019606a1-3b4c-7d8e-9f01-234567890abc"

start_date

string

Filter from date (YYYY-MM-DD)

Ejemplo:

"2026-04-01"

end_date

string

Filter to date (YYYY-MM-DD)

Ejemplo:

"2026-04-20"

page

string

Page number (1-based, default 1)

Ejemplo:

"1"

limit

string

Rows per page (default 10, max 100)

Ejemplo:

"10"

sort_order

string

Sort direction (default desc)

Ejemplo:

"desc"

Respuesta

items

object[] | null

requerido

Show child attributes

limit

integer<int64>

requerido

Ejemplo:

10

page

integer<int64>

requerido

Ejemplo:

1

total

integer<int64>

requerido

Ejemplo:

1

DICT y claves Pix

Cobros y códigos BR

Pagos y devoluciones

API de Pix Automático

Manejo de errores

List reconciliation logs

Autorizaciones

Parámetros de consulta

Respuesta