Skip to content

List files

Request

Returns a paginated list of metadata for files uploaded. Use profileId to retrieve files for a specific profile. If omitted, returns files across all profiles.

Security
ClientCredentialsToken
Query
pageNumberinteger, (int32), >= 1

The page number to retrieve. Must be at least 1.

Default:1
Example:pageNumber=1
pageSizeinteger, (int32), [ 1 .. 100 ]

The maximum number of files to return per page. Between 1 and 100.

Default:100
Example:pageSize=2
profileIdinteger, (int64)

Filter files by profile ID. Omit this parameter to retrieve files across all profiles.

Example:profileId=14556049
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
curl -X GET "https://api.wise.com/2027Q1/cases/files" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Responses

Paginated list of files

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
filesArray of objectsrequired

Collection of file metadata for the requested page. Ordered by createdAt descending and then fileId descending.

totalFilesinteger, (int64), >= 0required

Total number of files across all pages.

Example:3
Response
{
  "files": [
    {
      "profileId": 14556049,
      "fileId": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
      "fileName": "company-registration.pdf",
      "createdAt": "2026-09-30T10:00:00.123",
      "purpose": "GENERAL"
    },
    {
      "profileId": 14556049,
      "fileId": "b2c3d4e5-f6a7-4890-bcde-f12345678901",
      "fileName": "identity-document.png",
      "createdAt": "2026-09-29T10:00:00.123",
      "purpose": "GENERAL"
    }
  ],
  "totalFiles": 5
}