Upload an evidence file to a dispute

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/octet-stream' \
  --data '<string>'

package main

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

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload"

	payload := strings.NewReader("<string>")

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

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

	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/octet-stream'},
  body: '<string>'
};

fetch('https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload"

payload = "<string>"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/octet-stream"
}

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

print(response.text)

{
  "category": "BANK_FEE_ERROR",
  "createdAt": "2025-01-15T10:30:00Z",
  "description": "Transaction amount differs from expected",
  "exceptionId": "550e8400-e29b-41d4-a716-446655440001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "openedBy": "user@example.com",
  "state": "OPEN",
  "updatedAt": "2025-01-15T10:30:00Z",
  "evidence": [
    {
      "comment": "Bank statement attached",
      "disputeId": "550e8400-e29b-41d4-a716-446655440001",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "submittedAt": "2025-01-15T10:30:00Z",
      "submittedBy": "user@example.com",
      "fileUrl": "https://storage.example.com/evidence/doc123.pdf"
    }
  ],
  "reopenReason": "New evidence discovered",
  "resolution": "Counterparty confirmed error"
}

Upload an evidence file to a dispute

Streams an evidence file (pdf, png, jpeg, or csv) to tenant-scoped object storage and records the resulting object key on the dispute as a new evidence item. The comment arrives as a query parameter and the file bytes as the request body. The tenant is resolved from the JWT and the dispute from the path — never from the body. Fails closed (503) when object storage is not configured; rejects oversize bodies (413) and unsupported content types (415).

POST

/

v1

/

disputes

/

{disputeId}

/

evidence

/

upload

Upload an evidence file to a dispute

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/octet-stream' \
  --data '<string>'

package main

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

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload"

	payload := strings.NewReader("<string>")

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

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

	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/octet-stream'},
  body: '<string>'
};

fetch('https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://matcher.sandbox.lerian.net/v1/disputes/{disputeId}/evidence/upload"

payload = "<string>"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/octet-stream"
}

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

print(response.text)

{
  "category": "BANK_FEE_ERROR",
  "createdAt": "2025-01-15T10:30:00Z",
  "description": "Transaction amount differs from expected",
  "exceptionId": "550e8400-e29b-41d4-a716-446655440001",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "openedBy": "user@example.com",
  "state": "OPEN",
  "updatedAt": "2025-01-15T10:30:00Z",
  "evidence": [
    {
      "comment": "Bank statement attached",
      "disputeId": "550e8400-e29b-41d4-a716-446655440001",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "submittedAt": "2025-01-15T10:30:00Z",
      "submittedBy": "user@example.com",
      "fileUrl": "https://storage.example.com/evidence/doc123.pdf"
    }
  ],
  "reopenReason": "New evidence discovered",
  "resolution": "Counterparty confirmed error"
}

Authorizations

Authorization

string

header

required

Bearer token authentication (format: "Bearer {token}")

Headers

Content-Type

string

Evidence media type: application/pdf, image/png, image/jpeg, or text/csv

Example:

"application/pdf"

Path Parameters

disputeId

string<uuid>

required

Dispute ID (UUID)

Example:

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

Query Parameters

comment

string

Comment describing the uploaded evidence

Required string length: 1 - 1000

Example:

"Bank statement showing correct amount"

Body

application/octet-stream

The body is of type file.

Response

Created

category

enum<string>

required

Dispute category: BANK_FEE_ERROR (incorrect fee), UNRECOGNIZED_CHARGE, DUPLICATE_TRANSACTION, AMOUNT_MISMATCH, or OTHER

Available options:

BANK_FEE_ERROR,

UNRECOGNIZED_CHARGE,

DUPLICATE_TRANSACTION,

AMOUNT_MISMATCH,

OTHER

Example:

"BANK_FEE_ERROR"

createdAt

string

required

Creation timestamp as an RFC 3339 timestamp

Example:

"2025-01-15T10:30:00Z"

description

string

required

Description of the dispute

Example:

"Transaction amount differs from expected"

exceptionId

string

required

Identifier of the exception this dispute is for (UUID)

Example:

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

id

string

required

Unique identifier for the dispute (UUID)

Example:

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

openedBy

string

required

User who opened the dispute

Example:

"user@example.com"

state

enum<string>

required

Dispute state: DRAFT, OPEN, PENDING_EVIDENCE (awaiting evidence), WON, or LOST

Available options:

DRAFT,

OPEN,

PENDING_EVIDENCE,

WON,

LOST

Example:

"OPEN"

updatedAt

string

required

Last update timestamp as an RFC 3339 timestamp

Example:

"2025-01-15T10:30:00Z"

evidence

object[] | null

Evidence items submitted for this dispute (max 50)

Maximum array length: 50

Show child attributes

reopenReason

string

Reason recorded when the dispute was reopened

Example:

"New evidence discovered"

resolution

string

Resolution description recorded when the dispute was closed

Example:

"Counterparty confirmed error"