curl --request GET \
--url https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id} \
--header 'Authorization: Bearer <token>' \
--header 'x-grid-environment: <x-grid-environment>'import requests
url = "https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}"
headers = {
"x-grid-environment": "<x-grid-environment>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-grid-environment': '<x-grid-environment>', Authorization: 'Bearer <token>'}
};
fetch('https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_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://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_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>",
"x-grid-environment: <x-grid-environment>"
],
]);
$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://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-grid-environment", "<x-grid-environment>")
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://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}")
.header("x-grid-environment", "<x-grid-environment>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-grid-environment"] = '<x-grid-environment>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"created_at": "2026-03-05T08:14:01Z",
"destination": {
"currency": "USDC",
"payment_rail": "SOLANA",
"account_id": "ewa_abc123",
"address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV",
"external_account_id": "eba_abc123"
},
"id": "pi_tfr_9w7d3m2a",
"mode": "destination_address",
"object": "payment_intent",
"provider": "infinite",
"source": {
"currency": "USDC",
"payment_rail": "SOLANA",
"account_id": "ewa_abc123",
"address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV",
"external_account_id": "eba_abc123"
},
"source_amount": {
"currency": "USDC",
"display_value": "1.000000",
"exponent": 6,
"value": "1000000"
},
"status": "pending",
"updated_at": "2026-03-05T08:14:01Z",
"deposit": {
"amount": {
"currency": "USDC",
"display_value": "1.000000",
"exponent": 6,
"value": "1000000"
},
"deposit_type": "fiat",
"payment_rail": "SWIFT",
"account_id": "eba_abc123",
"account_number": "1234567890",
"bank_address_line": "270 PARK AVENUE, NEW YORK, NY",
"bank_name": "JPMORGAN CHASE BANK",
"beneficiary_name": "Acme Corp",
"clabe": "002010077777777771",
"iban": "GB33BUKB20201555555555",
"memo": "Payment reference",
"reference": "Invoice #2026-001",
"routing_number": "021000021",
"swift_bic": "CHASUS33",
"to_address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV"
},
"destination_amount": {
"currency": "USDC",
"display_value": "1.000000",
"exponent": 6,
"value": "1000000"
},
"next_action": {
"action_type": "await_funding"
},
"provider_fields": {},
"sign_prebuilt_tx": {
"encoding": "base64",
"transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAED..."
}
}Get a payment intent (v2)
Fetches a payment intent by ID from the internally selected provider and returns the same normalized v2 response shape.
curl --request GET \
--url https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id} \
--header 'Authorization: Bearer <token>' \
--header 'x-grid-environment: <x-grid-environment>'import requests
url = "https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}"
headers = {
"x-grid-environment": "<x-grid-environment>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-grid-environment': '<x-grid-environment>', Authorization: 'Bearer <token>'}
};
fetch('https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_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://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_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>",
"x-grid-environment: <x-grid-environment>"
],
]);
$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://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-grid-environment", "<x-grid-environment>")
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://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}")
.header("x-grid-environment", "<x-grid-environment>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://grid.squads.xyz/api/grid/v2/accounts/{address}/payment-intents/{payment_intent_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-grid-environment"] = '<x-grid-environment>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"created_at": "2026-03-05T08:14:01Z",
"destination": {
"currency": "USDC",
"payment_rail": "SOLANA",
"account_id": "ewa_abc123",
"address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV",
"external_account_id": "eba_abc123"
},
"id": "pi_tfr_9w7d3m2a",
"mode": "destination_address",
"object": "payment_intent",
"provider": "infinite",
"source": {
"currency": "USDC",
"payment_rail": "SOLANA",
"account_id": "ewa_abc123",
"address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV",
"external_account_id": "eba_abc123"
},
"source_amount": {
"currency": "USDC",
"display_value": "1.000000",
"exponent": 6,
"value": "1000000"
},
"status": "pending",
"updated_at": "2026-03-05T08:14:01Z",
"deposit": {
"amount": {
"currency": "USDC",
"display_value": "1.000000",
"exponent": 6,
"value": "1000000"
},
"deposit_type": "fiat",
"payment_rail": "SWIFT",
"account_id": "eba_abc123",
"account_number": "1234567890",
"bank_address_line": "270 PARK AVENUE, NEW YORK, NY",
"bank_name": "JPMORGAN CHASE BANK",
"beneficiary_name": "Acme Corp",
"clabe": "002010077777777771",
"iban": "GB33BUKB20201555555555",
"memo": "Payment reference",
"reference": "Invoice #2026-001",
"routing_number": "021000021",
"swift_bic": "CHASUS33",
"to_address": "8B57MCi1FX7ydB5SJUbWT5FWUwoHT88JsEfSFwNx32CV"
},
"destination_amount": {
"currency": "USDC",
"display_value": "1.000000",
"exponent": 6,
"value": "1000000"
},
"next_action": {
"action_type": "await_funding"
},
"provider_fields": {},
"sign_prebuilt_tx": {
"encoding": "base64",
"transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAED..."
}
}Authorizations
Your Grid API key from the Grid Dashboard
Headers
Environment (sandbox, production)
Path Parameters
Smart account address
Provider payment intent identifier
Response
Payment intent fetched
RFC3339 creation timestamp.
"2026-03-05T08:14:01Z"
Normalized destination party details.
Show child attributes
Show child attributes
Payment intent identifier.
"pi_tfr_9w7d3m2a"
Requested intent mode.
destination_address Resource type.
"payment_intent"
Provider that executed the request.
"infinite"
Normalized source party details.
Show child attributes
Show child attributes
Source amount breakdown.
Show child attributes
Show child attributes
Provider-backed payment intent status.
"pending"
RFC3339 update timestamp.
"2026-03-05T08:14:01Z"
Flat deposit action. Present when caller needs to transfer funds using returned instructions.
Show child attributes
Show child attributes
Destination amount breakdown when returned by provider.
Show child attributes
Show child attributes
Optional hint for additional follow-up action in future multi-step flows.
Show child attributes
Show child attributes
Provider-specific raw attributes for advanced integrations.
Flat signing action. Present when caller must sign and broadcast a prepared transaction.
Show child attributes
Show child attributes
Was this page helpful?