curl --request GET \
--url https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{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.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{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 => [
"Authorization: Bearer <token>"
],
]);
$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.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"billingAddress": {
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"countryCode": "AFG",
"postalCode": "<string>",
"state": "<string>"
},
"cardBrand": "UNKNOWN",
"cardStatus": "PENDING_ACTIVATION",
"cardType": "DIGITAL",
"cardholderName": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"expirationDate": "<string>",
"lastFourDigits": "<string>",
"mccGroups": [
{
"id": "<string>",
"active": true,
"createdAt": "2023-11-07T05:31:56Z",
"mccs": [
"<string>"
],
"name": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"reference": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"velocityControls": [
{
"id": "<string>",
"active": true,
"amountLimit": 123,
"createdAt": "2023-11-07T05:31:56Z",
"currencyCode": "<string>",
"name": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"velocityWindow": "DAY",
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mcc": "<string>",
"mccGroup": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"usageLimit": 123
}
],
"description": "<string>",
"nickname": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}Get debit card
Token types: APP, USER | Required scopes: debit_card:read:org
curl --request GET \
--url https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{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.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{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 => [
"Authorization: Bearer <token>"
],
]);
$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.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/embedded-banking/v1/debit-cards/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"billingAddress": {
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"countryCode": "AFG",
"postalCode": "<string>",
"state": "<string>"
},
"cardBrand": "UNKNOWN",
"cardStatus": "PENDING_ACTIVATION",
"cardType": "DIGITAL",
"cardholderName": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"expirationDate": "<string>",
"lastFourDigits": "<string>",
"mccGroups": [
{
"id": "<string>",
"active": true,
"createdAt": "2023-11-07T05:31:56Z",
"mccs": [
"<string>"
],
"name": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"reference": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"velocityControls": [
{
"id": "<string>",
"active": true,
"amountLimit": 123,
"createdAt": "2023-11-07T05:31:56Z",
"currencyCode": "<string>",
"name": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"velocityWindow": "DAY",
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mcc": "<string>",
"mccGroup": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"usageLimit": 123
}
],
"description": "<string>",
"nickname": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}Authorizations
Application (M2M) OAuth2 access token (client credentials).
Headers
ID of the organization to perform this operation on behalf of. Required for BANK and PLATFORM app token callers targeting a specific organization. If omitted, the request uses the authenticated caller's own organization. Must be a valid non-empty UUID. Present but malformed values return 400.
Path Parameters
Response
OK
The detail view of a single debit card. Extends the fields returned by the list endpoint (DebitCardResponse).
The billing address the issuer holds for this card.
Show child attributes
Show child attributes
The card network (brand) an issued card runs on, such as Visa or Mastercard.
UNKNOWN, VISA, MASTERCARD, DISCOVER, AMERICAN_EXPRESS PENDING_ACTIVATION, ACTIVE, LOCKED, CLOSED DIGITAL, PHYSICAL The MCC groups allowed on this card.
Show child attributes
Show child attributes
Velocity controls scoped to this card. Single-purchase, daily, and monthly limits appear here as
controls with a TRANSACTION, DAY, and MONTH window respectively.
Show child attributes
Show child attributes
Was this page helpful?