List MED infractions

curl --request GET \
  --url https://api.example.com/v1/med/infractions \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/v1/med/infractions"

	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/v1/med/infractions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "counterpartIspb": "87654321",
      "createdAt": "2024-01-01T12:00:00.000Z",
      "creatorIspb": "12345678",
      "endToEndId": "E1234567820240101000000000000001",
      "infractionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "reason": 1,
      "reasonDescription": "Solicitacao de refund",
      "status": 0,
      "statusDescription": "Aberto",
      "tpSitOrigem": 0,
      "tpSitOrigemDescription": "Golpe/Estelionato",
      "updatedAt": "2024-01-01T12:05:00.000Z",
      "analysisDetails": "Confirmed.",
      "analysisResult": 0,
      "analysisResultDescription": "Aceita",
      "details": "Suspected scam.",
      "fraudMarkerId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "recoveryId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "vlrInfracao": 15000
    }
  ]
}

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

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

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

Lists the infractions detected by the worker pollers (filed by this institution or against it), filterable by status, role ISPB, and the suspect payment’s endToEndId. Read projection — no JDPI round-trip. The role ISPBs name the DIRECT participant, and the indirect participants riding it share its infractions; indirectId narrows the listing to ONE indirect — only the infractions over a payment this deployment recorded for that indirect (the payment’s own indirectId, as GET /v1/transactions?indirectId= reads it), never another indirect’s, never one over the direct participant’s own payment, and never one over a payment this deployment did not book. A token confined to one indirect has to name it. A malformed indirectId is 400 PIX-0061; an empty match is a 200 with an empty data array.

GET

med

infractions

curl --request GET \
  --url https://api.example.com/v1/med/infractions \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/v1/med/infractions"

	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/v1/med/infractions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "counterpartIspb": "87654321",
      "createdAt": "2024-01-01T12:00:00.000Z",
      "creatorIspb": "12345678",
      "endToEndId": "E1234567820240101000000000000001",
      "infractionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "reason": 1,
      "reasonDescription": "Solicitacao de refund",
      "status": 0,
      "statusDescription": "Aberto",
      "tpSitOrigem": 0,
      "tpSitOrigemDescription": "Golpe/Estelionato",
      "updatedAt": "2024-01-01T12:05:00.000Z",
      "analysisDetails": "Confirmed.",
      "analysisResult": 0,
      "analysisResultDescription": "Aceita",
      "details": "Suspected scam.",
      "fraudMarkerId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "recoveryId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "vlrInfracao": 15000
    }
  ]
}

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

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

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

status

string

Filter on stRelatoInfracao (0=Aberto, 1=Recebido, 2=Cancelado, 3=Analisado).

Ejemplo:

"0"

counterpartIspb

string

Filter on the counterparty ISPB (infractions filed against this institution).

Ejemplo:

"87654321"

creatorIspb

string

Filter on the creator ISPB (infractions this institution filed).

Ejemplo:

"12345678"

end_to_end_id

string

Filter on the suspect payment's endToEndId.

Ejemplo:

"E1234567820240101000000000000001"

indirectId

string<uuid>

The registered indirect participant (UUID) whose infractions are listed. OPTIONAL: omit it and the listing is not narrowed by indirect. Named, only the infractions over a payment this deployment recorded for that indirect come back - never another indirect's, never one over a payment of the direct participant itself, and never one over a payment this deployment did not book. A token confined to one indirect has to name it here. Not a valid UUID is 400 PIX-0061.

Ejemplo:

"3f2504e0-4f89-41d3-9a0c-0305e82c3301"

Respuesta

data

object[] | null

requerido

The list of detected infractions, newest first.

Show child attributes

APIs del participante directo

APIs de participantes indirectos

List MED infractions

Autorizaciones

Parámetros de consulta

Respuesta