curl --request GET \
--url https://api.paywint.com/api/platform/card/list/{user_id} \
--header 'X-Platform-ID: <x-platform-id>' \
--header 'X-Signature: <x-signature>'import requests
url = "https://api.paywint.com/api/platform/card/list/{user_id}"
headers = {
"X-Platform-ID": "<x-platform-id>",
"X-Signature": "<x-signature>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Platform-ID': '<x-platform-id>', 'X-Signature': '<x-signature>'}
};
fetch('https://api.paywint.com/api/platform/card/list/{user_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.paywint.com/api/platform/card/list/{user_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Platform-ID: <x-platform-id>",
"X-Signature: <x-signature>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.paywint.com/api/platform/card/list/{user_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Platform-ID", "<x-platform-id>")
req.Header.Add("X-Signature", "<x-signature>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.paywint.com/api/platform/card/list/{user_id}")
.header("X-Platform-ID", "<x-platform-id>")
.header("X-Signature", "<x-signature>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.paywint.com/api/platform/card/list/{user_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Platform-ID"] = '<x-platform-id>'
request["X-Signature"] = '<x-signature>'
response = http.request(request)
puts response.read_body{
"success": true,
"status_code": 200,
"message": "Success",
"records": [
{
"user_id": "134dd73b-e378-4a0b-bbe8-447c8b9e4b1f",
"card_id": "fe0f3346-2f9a-4c5e-b104-0b95c18417fc",
"card_number": "4242",
"card_exp": "12/2029",
"card_nick_name": "Primary Visa",
"card_type": "CREDIT",
"first_name": "John",
"last_name": "Doe",
"address": "123 Main St",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"is_blocked": false,
"card_image1": "https://cdn.example.com/cards/front_134dd73b.png",
"card_image2": "https://cdn.example.com/cards/back_134dd73b.png",
"card_images_required": false,
"withdrawal_confirm_required": true,
"payment_confirm_required": false,
"compliance_check_required": true,
"is_limited": true
}
],
"totalRecords": 0,
"queryGeneratedTime": 1783679844
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}List Cards
Retrieve a list of all cards associated with the authenticated user.
Usage Notes:
Each returned card may include one or more status flags that indicate required user actions or usage limitations:
card_images_required: The cardholder must upload both front and back images before the card can be used for any transactions.withdrawal_confirm_required: A withdrawal setup or confirmation step must be completed before withdrawals are allowed.payment_confirm_required: Additional registration or verification is required before new payments can be made with this card.compliance_check_required: Indicates whether KYC/KYB compliance should be checked before card payments.is_limited: The user has reached their daily payment limit. → Note: No new payments can be made today using card, but withdrawals are still permitted.
If any of the first three flags (card_images_required, withdrawal_confirm_required, or payment_confirm_required) are true, the card must be updated before use.
→ Use the Update Card Endpoint to complete the necessary steps.
curl --request GET \
--url https://api.paywint.com/api/platform/card/list/{user_id} \
--header 'X-Platform-ID: <x-platform-id>' \
--header 'X-Signature: <x-signature>'import requests
url = "https://api.paywint.com/api/platform/card/list/{user_id}"
headers = {
"X-Platform-ID": "<x-platform-id>",
"X-Signature": "<x-signature>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Platform-ID': '<x-platform-id>', 'X-Signature': '<x-signature>'}
};
fetch('https://api.paywint.com/api/platform/card/list/{user_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.paywint.com/api/platform/card/list/{user_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Platform-ID: <x-platform-id>",
"X-Signature: <x-signature>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.paywint.com/api/platform/card/list/{user_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Platform-ID", "<x-platform-id>")
req.Header.Add("X-Signature", "<x-signature>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.paywint.com/api/platform/card/list/{user_id}")
.header("X-Platform-ID", "<x-platform-id>")
.header("X-Signature", "<x-signature>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.paywint.com/api/platform/card/list/{user_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Platform-ID"] = '<x-platform-id>'
request["X-Signature"] = '<x-signature>'
response = http.request(request)
puts response.read_body{
"success": true,
"status_code": 200,
"message": "Success",
"records": [
{
"user_id": "134dd73b-e378-4a0b-bbe8-447c8b9e4b1f",
"card_id": "fe0f3346-2f9a-4c5e-b104-0b95c18417fc",
"card_number": "4242",
"card_exp": "12/2029",
"card_nick_name": "Primary Visa",
"card_type": "CREDIT",
"first_name": "John",
"last_name": "Doe",
"address": "123 Main St",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US",
"is_blocked": false,
"card_image1": "https://cdn.example.com/cards/front_134dd73b.png",
"card_image2": "https://cdn.example.com/cards/back_134dd73b.png",
"card_images_required": false,
"withdrawal_confirm_required": true,
"payment_confirm_required": false,
"compliance_check_required": true,
"is_limited": true
}
],
"totalRecords": 0,
"queryGeneratedTime": 1783679844
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Headers
Unique platform identifier (UUID). You receive this during onboarding. Must be sent with every API request.
HMAC-SHA256 request signature for authentication. Use your platform secret key to compute it as: METHOD + PATH + QUERY + BODY_HASH.
Path Parameters
Unique identifier (UUID) of the user whose cards are being retrieved.
Response
Successful Response
Indicates whether the request was processed successfully.
true
HTTP status code representing the result of the request.
Short, human-readable message describing the outcome of the request.
List of result items returned for the current page.
Show child attributes
Show child attributes
Total number of matching records in the database, useful for paginating the full dataset.
Unix timestamp (in seconds) indicating when this response was generated.

