Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wise profile API

A profile represents an identity that can send and receive money through Wise — either a personal profile (an individual) or a business profile (a company). Most API endpoints require a `profileId` parameter, which is the ID of either profile type.

Wise profile API is one of 47 APIs that Wise publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include profile. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 26 operations across 16 paths, and defines 6 schemas. It is described by OpenAPI 3.1.0.

Requests are made against 2 base URLs: https://api.wise.com, https://api.wise-sandbox.com.

26 operations 16 paths 6 schemas 1 DELETE7 GET11 POST7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
Base URL
https://api.wise.com/v2
Authentication
HTTP Bearer, HTTP Bearer, HTTP Bearer, HTTP Basic
Resource Areas
1

Authentication & Security 4

Wise profile API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (UserToken). It accepts HTTP bearer tokens (JWT) (PersonalToken). It accepts HTTP bearer tokens (JWT) (ClientCredentialsToken). It accepts HTTP basic authentication (BasicAuth).

  • UserToken — User Access Token for making API calls on behalf of a Wise user. Can be obtained via two OAuth 2.0 flows: - registrationcode grant: For partners creating users…
  • PersonalToken — Personal API Token for individual personal or small business users. Generated from Wise.com Settings Connect and manage apps API tokens. Has limited API access…
  • ClientCredentialsToken — Application-level token for partner operations that don't require a specific user context, such as bulk settlement and card spend controls. Obtained via POST /…
  • BasicAuth — Basic Authentication using your Client ID and Client Secret as the username and password. Client credentials are provided by Wise when your partnership begins.…

Paths & Operations 26

Across 16 paths, the API surfaces 26 operations — 1 DELETE, 7 GET, 11 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

profile 26

A profile represents an identity that can send and receive money through Wise — either a personal profile (an individual) or a business profile (a company). Most API endpoints req…

POST
/v1/profilesdeprecated
Create a profile (V1)
profileCreateV1 1 param body → 200429
PUT
/v1/profilesdeprecated
Update a profile (V1)
profileUpdateV1 1 param body → 200429
GET
/v2/profiles
List profiles for a user account
profileList 1 param → 200429
POST
/v2/profiles/personal-profile
Create a personal profile
profilePersonalCreate 2 params body → 200429
POST
/v2/profiles/business-profile
Create a business profile
profileBusinessCreate 2 params body → 200429
POST
/v3/profiles/business-profile
Create a business profile (V3)
profileBusinessCreateV3 2 params body → 200429
GET
/v2/profiles/{profileId}
Retrieve a profile by ID
profileGet 2 params → 200429
PUT
/v2/profiles/{profileId}/personal-profile
Update a personal profile
profilePersonalUpdate 2 params body → 200429
PUT
/v2/profiles/{profileId}/business-profile
Update a business profile
profileBusinessUpdate 2 params body → 200429
GET
/v3/profiles/{profileId}/business-profile/business-representative
Retrieve business representative
profileBusinessRepresentativeGet 2 params → 200429
PUT
/v3/profiles/{profileId}/business-profile/business-representative
Update business representative
profileBusinessRepresentativeUpdate 2 params body → 200429
POST
/v1/profiles/{profileId}/verification-documents
Create an identification document
profileVerificationDocumentCreate 2 params body → 200429
PUT
/v1/profiles/{profileId}/verification-documents
Update an identification document
profileVerificationDocumentUpdate 2 params body → 200400429
POST
/v1/profiles/{profileId}/directors
Create business directors
profileDirectorCreate 2 params body → 200429
GET
/v1/profiles/{profileId}/directors
List business directors
profileDirectorList 2 params → 200429
PUT
/v1/profiles/{profileId}/directors
Update business directors
profileDirectorUpdate 2 params body → 200429
POST
/v1/profiles/{profileId}/ubos
Create business ultimate owners
profileUboCreate 2 params body → 200429
GET
/v1/profiles/{profileId}/ubos
List business ultimate owners
profileUboList 2 params → 200429
PUT
/v1/profiles/{profileId}/ubos
Update business ultimate owners
profileUboUpdate 2 params body → 200429
POST
/v1/profiles/{profileId}/update-window
Open an update window
profileUpdateWindowOpen 2 params → 200429
DELETE
/v1/profiles/{profileId}/update-window
Close an update window
profileUpdateWindowClose 2 params → 200429
GET
/v1/profiles/{profileId}/extension-requirementsdeprecated
Retrieve profile extension requirements
profileExtensionRequirementsGet 2 params → 200429
POST
/v1/profiles/{profileId}/extension-requirementsdeprecated
Update profile extensions dynamically
profileExtensionRequirementsPost 2 params body → 200429
POST
/v1/profiles/{profileId}/extensionsdeprecated
Submit profile extensions
profileExtensionsCreate 2 params body → 200429
GET
/v1/profiles/{profileId}/extensionsdeprecated
Retrieve profile extensions
profileExtensionsGet 2 params → 200429
POST
/v3/profiles/{profileId}/verification-status/bank-transfer
Check profile verification status
profileVerificationStatusCheck 3 params → 200429

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are business-profile (21 properties), personal-profile (18 properties), address (7 properties), ubo (7 properties). Each schema is shown below with its type and property counts.

business-profile
object
21 properties 1 required
ubo
object
7 properties
profile
A profile represents an identity that can send and receive money through Wise. There are two types: Personal (an individual) and Business (a company). The fiel…
address
object
Address associated with a profile.
7 properties
personal-profile
object
18 properties 1 required
director
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wise-profile-api-openapi.yml Raw ↑

Other APIs Wise publishes across the network.

Wise 3ds API
Wise activity API
Wise address API
Wise balance API
Wise balance-statement API
Wise bank-account-details API
Wise batch-group API
Wise bulk-settlement API
Wise card API
Wise card-kiosk-collection API
Wise card-order API
Wise card-sensitive-details API