Skip to content

Files

Securely upload supporting documentation to Wise. Each upload returns a file ID, which you then pass to any endpoint that documents support for it. Files currently work with the Cases API only.

Operations

Upload a file

Request

Uploads a file that can be used as supporting documentation for cases. All files are scanned for malware before being accepted.

Security
ClientCredentialsToken
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
Bodymultipart/form-datarequired
filestringrequired

The file to upload. Do not include personally identifying information in the file name. Must be one of the supported content types (application/pdf, image/jpeg, image/png) and must not exceed 15 MB. File name must not exceed 128 characters and the file extension must match the content type (e.g. .pdf for application/pdf).

submissionDataobjectrequired

Metadata for the file upload, sent as the submissionData part of the multipart request.

Example:
{
  "profileId": 14556049,
  "purpose": "GENERAL"
}
curl -i -X POST \
  https://api.wise.com/2026Q4/cases/files \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -F file=string \
  -F 'submissionData={"profileId":14556049,"purpose":"GENERAL"}'

Responses

File uploaded successfully

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Bodyapplication/json
profileIdinteger, (int64)required

The ID of the profile this file belongs to.

Example:14556049
fileIdstring, (uuid), = 36 charactersrequired

Unique identifier of the uploaded file (UUID v4).

Example:"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
fileNamestring, <= 128 charactersrequired

The original name of the uploaded file.

Example:"company-registration.pdf"
Response
{
  "profileId": 14556049,
  "fileId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "fileName": "company-registration.pdf"
}