Get DICT MED operation status

curl --request GET \
  --url https://api.example.com/api/v1/dict/operations/{id} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/api/v1/dict/operations/{id}"

	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/api/v1/dict/operations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "createdAt": "2026-06-14T12:00:00Z",
  "kind": "infraction",
  "operationId": "01930000-0000-7000-8000-000000000000",
  "requestFingerprint": "2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae",
  "status": "UNKNOWN_OUTCOME",
  "updatedAt": "2026-06-14T12:00:00Z",
  "verb": "create",
  "bacen": {
    "correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "lastModified": "2026-06-14T12:00:00Z",
    "responseTime": "2026-06-14T12:00:00Z"
  },
  "bacenResourceId": "550e8400-e29b-41d4-a716-446655440000"
}

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

GET

api

dict

operations

{id}

Get DICT MED operation status

curl --request GET \
  --url https://api.example.com/api/v1/dict/operations/{id} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/api/v1/dict/operations/{id}"

	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/api/v1/dict/operations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "createdAt": "2026-06-14T12:00:00Z",
  "kind": "infraction",
  "operationId": "01930000-0000-7000-8000-000000000000",
  "requestFingerprint": "2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae",
  "status": "UNKNOWN_OUTCOME",
  "updatedAt": "2026-06-14T12:00:00Z",
  "verb": "create",
  "bacen": {
    "correlationId": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
    "lastModified": "2026-06-14T12:00:00Z",
    "responseTime": "2026-06-14T12:00:00Z"
  },
  "bacenResourceId": "550e8400-e29b-41d4-a716-446655440000"
}

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

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

string<uuid>

required

Durable MED operation-intent id (operationId), returned by a create/lifecycle-transition backlog route on every outcome — synchronous success, a 202 pending outcome, or a rejection.

Response

Durable MED operation-intent status.

createdAt

string

required

Operation reservation timestamp (RFC 3339, UTC).

Example:

"2026-06-14T12:00:00Z"

kind

enum<string>

required

MED resource kind this operation concerns.

Available options:

infraction,

refund,

fraud_marker,

funds_recovery

Example:

"infraction"

operationId

string

required

This attempt's own identity; never the business resource's id.

Example:

"01930000-0000-7000-8000-000000000000"

requestFingerprint

string

required

Lowercase-hex SHA-256 of this operation's own canonical request — never the request body itself. Required as the digest field of a MANUAL_REVIEW resolution decision (ATTACH_BACEN_RESOURCE or CONFIRM_NOT_APPLIED) so the resolution callback can authenticate it is targeting the right operation.

Example:

"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae"

status

enum<string>

required

Durable operation-intent lifecycle state — OUR attempt's status, distinct from the business resource's own BACEN-reported status. LOCAL_FAILURE means the attempt never reached BACEN (a local dependency fault, e.g. the DICT signer) — never BACEN's own verdict.

Available options:

RESERVED,

SUBMITTED,

CONFIRMED,

SYNC_PENDING,

REJECTED,

UNKNOWN_OUTCOME,

MANUAL_REVIEW,

ABANDONED,

COMPLETED,

LOCAL_FAILURE

Example:

"UNKNOWN_OUTCOME"

updatedAt

string

required

Last status-transition timestamp (RFC 3339, UTC).

Example:

"2026-06-14T12:00:00Z"

verb

enum<string>

required

BACEN verb this operation reserved.

Available options:

create,

update,

acknowledge,

close,

cancel,

refund

Example:

"create"

bacen

object

BACEN's own sanitized operational envelope for the last interaction this operation recorded (correlation id + response time only, never payload); omitted when no BACEN interaction has landed yet.

Show child attributes

bacenResourceId

string

BACEN-assigned resource UUID, once known; absent while a create's outcome is still unresolved.

Example:

"550e8400-e29b-41d4-a716-446655440000"