Ask Moov Beta
Generative AI is experimental and can make mistakes.
Guides Use cases API Changelog
  1. API reference
  2. Money movement
  3. Disputes

Upload evidence file

Uploads a file as evidence for a dispute. Read our disputes guide to learn more.

To use this endpoint from the browser, you’ll need to specify the /accounts/{your-account-id}/transfers.write scope when generating a token.
POST
/accounts/{accountID}/disputes/{disputeID}/evidence-file
cURL Go 
1
2
3
4
5

curl -X POST "https://api.moov.io/accounts/{accountID}/disputes/{disputeID}/evidence-file" \
  -H "Authorization: Bearer {token}" \
  --form \
  -F "file=@/path/to/your/file.txt" \
  -F "evidenceType=proof-of-delivery"

1
2
3
4
5
6
7

mc, _ := moov.NewClient()

var accountID string
var disputeID string
file, _ := os.Open("path/to/test.pdf")

mc.UploadEvidenceFile(ctx, accountID, disputeID, moov.EvidenceType_CoverLetter, "test.pdf", file, "application/pdf")
201 403 404 422 429 500
File was uploaded successfully.
Details of a successfully uploaded evidence file.
{
  "createdOn": "2019-08-24T14:15:22Z",
  "disputeID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "evidenceID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "evidenceType": "receipt",
  "filename": "string",
  "mimeType": "string",
  "size": 0
}
The user is not authorized to make the request.
Request received, but resource was not found.
The parameters provided are not processable.
Request was refused due to rate limiting.

Response headers

Retry-After

number
Invalid request, an error message will be available in the response body.
Response for http requests that failed

Path parameters

accountID

string <uuid> required
ID of the account.

disputeID

string <uuid> required
ID of dispute

Body

multipart/form-data
The file to upload as evidence.

evidenceType

string<enum> required
The type of evidence being uploaded.
Possible values: receipt, proof-of-delivery, cancelation-policy, terms-of-service, customer-communication, generic-evidence, cover-letter, other

file

string<binary> required

The file to upload as evidence. Valid types are [jpeg, tiff, pdf].

The Content-Type header for this form part must be one of the following:

  • image/jpeg
  • image/tiff
  • application/pdf

Response

application/json
Details of a successfully uploaded evidence file.

createdOn

string<date-time> <=24 characters required

disputeID

string<uuid> <=36 characters required
UUID

evidenceID

string<uuid> <=36 characters required
UUID

evidenceType

string<enum> required
The type of evidence being uploaded.
Possible values: receipt, proof-of-delivery, cancelation-policy, terms-of-service, customer-communication, generic-evidence, cover-letter, other

filename

string required

mimeType

string required

size

integer<int64> required