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 a secure vault 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"
}
}