Attach evidence to MED case

Attaches an evidence reference (URL, text, or document reference) to a MED case.

POST /api/v1/core/med/{caseID}/evidence

Attach evidence to MED case

cURL

curl --request POST \
  --url https://spi.sandbox.lerian.net/api/v1/core/med/{caseID}/evidence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "reference": "<string>",
  "type": "<string>",
  "addedBy": "<string>"
}
'

201

{
  "analysisDeadlineAt": "<string>",
  "caseId": "<string>",
  "completionDeadlineAt": "<string>",
  "createdAt": "<string>",
  "evidenceReferences": [
    {
      "addedAt": "<string>",
      "addedBy": "<string>",
      "description": "<string>",
      "reference": "<string>",
      "type": "<string>"
    }
  ],
  "id": "<string>",
  "originalEndToEndId": "<string>",
  "reason": "<string>",
  "status": "<string>",
  "updatedAt": "<string>",
  "refundAmount": 123,
  "resolution": "<string>",
  "resolvedAt": "<string>"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

Idempotency-Key · string

Idempotency key, max 255 characters

Path Parameters

caseID · string · required

MED case ID

Body

application/json

description · string · required

Human-readable description of what the evidence shows.

Example:

"Screenshot of fraudulent transaction notification"

reference · string · required

Locator for the evidence, interpreted according to Type (e.g. the document URL).

Example:

"https://example.com/evidence/doc-123"

type · string · required

Kind of evidence being attached (e.g. URL pointing to a supporting document).

Example:

"URL"

addedBy · string

Response

201

application/json

Created

analysisDeadlineAt · string · required

UTC deadline for the initial analysis window (7 days), RFC 3339 format.

Example:

"2025-03-17T14:30:00Z"

caseId · string · required

Caller-assigned business identifier for the MED dispute case.

Example:

"MED-2025-001"

completionDeadlineAt · string · required

UTC deadline for full case completion (10 days), RFC 3339 format.

Example:

"2025-04-06T14:30:00Z"

createdAt · string · required

UTC timestamp when the case was created, RFC 3339 format.

Example:

"2025-03-07T14:30:00Z"

evidenceReferences · object[] | null · required

Evidence attachments supporting the dispute.

Show child attributes

id · string · required

Server-assigned UUID of the MED case.

Example:

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

originalEndToEndId · string · required

PIX EndToEndID of the original disputed transaction, format E{ISPB}{YYYYMMDD}{uniqueID}.

Example:

"E1234567820250307ABCDEFGHIJKLMNO"

reason · string · required

Motivation for the dispute: FRAUD, OPERATIONAL_FLAW, or CANCELLED.

Example:

"FRAUD"

status · string · required

Lifecycle state: INITIATED, UNDER_ANALYSIS, AWAITING_RESPONSE, APPROVED, REJECTED, EXPIRED, or COMPLETED.

Example:

"INITIATED"

updatedAt · string · required

UTC timestamp of the last update to the case, RFC 3339 format.

Example:

"2025-03-07T14:30:00Z"

refundAmount · integer<int64>

Refund amount in centavos (BRL minor units); zero unless the case was resolved with a refund.

Example:

0

resolution · string

Outcome once resolved: APPROVED, REJECTED, CANCELLED_BY_OPENER, DEADLINE_EXPIRED, or AUTO_APPROVED; empty while unresolved.

Example:

""

resolvedAt · string

UTC timestamp when the case was resolved, RFC 3339 format; empty while unresolved.

Example:

""