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 card API

Manage your customers' cards programmatically. These APIs allow you to list cards, retrieve card details, control card status, and manage spending permissions.**Key capabilities:**- List and retrieve card details for a profile- Update card status (active, frozen, blocked)- Control spending permissions (e-commerce, ATM, contactless, magnetic stripe, etc.)- Reset PIN attempt counter after incorrect PIN entries- Update card phone number for verification purposes{% admonition type="info" %}For accessing sensitive card data (PAN, CVV, PIN), see the [Sensitive Card Details API](/api-reference/card-sensitive-details). For ordering new cards, see the [Card Orders API](/api-reference/card-order). For transaction history, see the [Card Transactions API](/api-reference/card-transaction).{% /admonition %}

Wise card 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 card. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 8 operations across 7 paths, and defines 2 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.

8 operations 7 paths 2 schemas 3 GET2 PATCH1 POST2 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 card 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 8

Across 7 paths, the API surfaces 8 operations — 3 GET, 2 PATCH, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

card 8

Manage your customers' cards programmatically. These APIs allow you to list cards, retrieve card details, control card status, and manage spending permissions. Key capabilities: -…

GET
/v3/spend/profiles/{profileId}/cards
List cards for a profile
cardList 4 params → 200429
GET
/v3/spend/profiles/{profileId}/cards/{cardToken}
Get card details
cardGet 3 params → 200429
PUT
/v3/spend/profiles/{profileId}/cards/{cardToken}/status
Update card status
cardStatusUpdate 3 params body → 200429
POST
/v3/spend/profiles/{profileId}/cards/{cardToken}/reset-pin-count
Reset PIN count
cardPinCountReset 3 params → 200429
GET
/v3/spend/profiles/{profileId}/cards/{cardToken}/spending-permissions
Get card spending permissions
cardPermissionsGet 3 params → 200429
PATCH
/v3/spend/profiles/{profileId}/cards/{cardToken}/spending-permissionsdeprecated
Update a single card permission
cardPermissionsUpdate 3 params body → 200429
PATCH
/v4/spend/profiles/{profileId}/cards/{cardToken}/spending-permissions
Bulk update card permissions
cardPermissionsBulkUpdate 3 params body → 200429
PUT
/v3/spend/profiles/{profileId}/cards/{cardToken}/phone-numberdeprecated
Update phone number
cardPhoneNumberUpdate 3 params body → 200429

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Card (13 properties), Permission (3 properties). Each schema is shown below with its type and property counts.

Card
object
The Card resource represents a Wise card linked to a profile.
13 properties
Permission
object
Spending permission configuration for a card.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wise-card-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-kiosk-collection API
Wise card-order API
Wise card-sensitive-details API
Wise card-transaction API