Retrieve an Instrument
Return a single instrument by ID.
GET
/
v1
/
instruments
/
{id}
Retrieve an instrument
curl --request GET \
--url https://api.antonpayments.com/v1/instruments/{id} \
--header 'Authorization: Bearer <token>' \
--header 'DPoP: <api-key>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>', DPoP: '<api-key>'}};
fetch('https://api.antonpayments.com/v1/instruments/{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.antonpayments.com/v1/instruments/{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>",
"DPoP: <api-key>"
],
]);
$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.antonpayments.com/v1/instruments/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("DPoP", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"id": "ins_01HX8Z9K0M2N3P4Q5R6S7T8UA2",
"beneficiary_id": "ben_01HX8Z9K0M2N3P4Q5R6S7T8UA1",
"merchant_id": "mer_01HX8Z9K0M2N3P4Q5R6S7T8UZZ",
"method": "iban",
"currency": "EUR",
"country": "DE",
"label": "Primary EUR account",
"display_last4": "5432",
"display_bank": "Deutsche Bank",
"masked_account": "DE89****5432",
"status": "active",
"is_default": true,
"created_at": "2026-04-15T14:30:00Z",
"updated_at": "2026-04-15T14:30:00Z"
}
}Authorizations
Per-request DPoP proof JWT (RFC 9449). MUST accompany the Authorization: DPoP <access_token> header on every protected operation. The proof is signed by the merchant's private DPoP key and carries htm, htu, iat, jti, and ath claims.
Path Parameters
Pattern:
^ins_[a-zA-Z0-9]+$Response
Instrument.
A payment destination attached to a beneficiary. Credentials (account numbers, wallet addresses, card PANs) are tokenized in Basis Theory and never returned by the API. Only masked display fields and method metadata are exposed.
Show child attributes
Show child attributes
Example:
{
"id": "ins_01HX8Z9K0M2N3P4Q5R6S7T8UA2",
"beneficiary_id": "ben_01HX8Z9K0M2N3P4Q5R6S7T8UA1",
"merchant_id": "mer_01HX8Z9K0M2N3P4Q5R6S7T8UZZ",
"method": "iban",
"currency": "EUR",
"country": "DE",
"label": "Primary EUR account",
"display_last4": "5432",
"display_bank": "Deutsche Bank",
"masked_account": "DE89****5432",
"status": "active",
"is_default": true,
"created_at": "2026-04-15T14:30:00Z",
"updated_at": "2026-04-15T14:30:00Z"
}
Was this page helpful?
⌘I
Retrieve an instrument
curl --request GET \
--url https://api.antonpayments.com/v1/instruments/{id} \
--header 'Authorization: Bearer <token>' \
--header 'DPoP: <api-key>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>', DPoP: '<api-key>'}};
fetch('https://api.antonpayments.com/v1/instruments/{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.antonpayments.com/v1/instruments/{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>",
"DPoP: <api-key>"
],
]);
$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.antonpayments.com/v1/instruments/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("DPoP", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"id": "ins_01HX8Z9K0M2N3P4Q5R6S7T8UA2",
"beneficiary_id": "ben_01HX8Z9K0M2N3P4Q5R6S7T8UA1",
"merchant_id": "mer_01HX8Z9K0M2N3P4Q5R6S7T8UZZ",
"method": "iban",
"currency": "EUR",
"country": "DE",
"label": "Primary EUR account",
"display_last4": "5432",
"display_bank": "Deutsche Bank",
"masked_account": "DE89****5432",
"status": "active",
"is_default": true,
"created_at": "2026-04-15T14:30:00Z",
"updated_at": "2026-04-15T14:30:00Z"
}
}