How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wise oauth-token API

Exchange client credentials or authorisation grants for OAuth 2.0 access tokens. All grant types use `POST /oauth/token` with basic authentication (your `client_id` and `client_secret`).Depending on the grant type, this endpoint issues either a **client credentials token** or a **user token**.Client credentials token {% .title-3 .m-t-5 %}An application-level token for requests that aren't tied to a specific Wise user, such as generating un-authenticated quotes and subscribing to application webhooks. Valid for 12 hours.- `client_credentials` — the only grant type for this token.User token {% .title-3 .m-t-5 %}A token for making API calls on behalf of a specific Wise user, such as creating transfers and managing balances. Access tokens are valid for 12 hours and can be refreshed using a refresh token. Grant types:- `registration_code` — for partners that create Wise users via API. Exchanges a registration code for a user access token and refresh token.- `authorization_code` — for partners using the OAuth redirect flow. Exchanges an authorisation code for a user access token and refresh token.- `refresh_token` — obtain a new user access token without requiring the user to re-authorise.Managing token expiration {% #managing-token-expiration .title-3 .m-t-5 %}Access tokens are valid for 12 hours. You can request a new access token whenever it's close to expiring — there is no need to wait for the actual expiration to happen first. Depending on how your application uses the Wise Platform API, requesting a new access token before attempting a series of API calls on behalf of an individual user will avoid issues with expired access tokens.

Wise oauth-token API is one of 48 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 OAuth Token. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 1 operation across 1 path, and defines 5 schemas. It is described by OpenAPI 3.2.0.

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

1 operations 1 paths 5 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 4

Wise oauth-token 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 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

oauth-token 1

Exchange client credentials or authorisation grants for OAuth 2.0 access tokens. All grant types use POST /oauth/token with basic authentication (your clientid and clientsecret).…

POST
/oauth/token
Create an OAuth token
oauthTokenCreate 1 param body → 200400401429

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are token-response (9 properties), authorization-code-grant (4 properties), registration-code-grant (4 properties), refresh-token-grant (2 properties). Each schema is shown below with its type and property counts.

registration-code-grant
object
4 properties 4 required
token-response
object
9 properties
client-credentials-grant
object
1 property 1 required
authorization-code-grant
object
4 properties 4 required
refresh-token-grant
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wise-oauth-token-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
Where this information came from

This is an independent, third-party profile of Wise oauth-token API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.