Skip to main content
GET
/
api
/
grid
/
v2
/
accounts
/
{address}
/
payment-intents
/
{payment_intent_id}
Get a payment intent (v2)
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>'
{
  "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

​
Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Headers

​
x-grid-environment
string
required

Environment (sandbox, production)

Path Parameters

​
address
string
required

Smart account address

​
payment_intent_id
string
required

Provider payment intent identifier

Response

Payment intent fetched

​
created_at
string
required

RFC3339 creation timestamp.

Example:

"2026-03-05T08:14:01Z"

​
destination
object
required

Normalized destination party details.

​
id
string
required

Payment intent identifier.

Example:

"pi_tfr_9w7d3m2a"

​
mode
enum<string>
required

Requested intent mode.

Available options:
destination_address
​
object
string
required

Resource type.

Example:

"payment_intent"

​
provider
string
required

Provider that executed the request.

Example:

"infinite"

​
source
object
required

Normalized source party details.

​
source_amount
object
required

Source amount breakdown.

​
status
string
required

Provider-backed payment intent status.

Example:

"pending"

​
updated_at
string
required

RFC3339 update timestamp.

Example:

"2026-03-05T08:14:01Z"

​
deposit
object

Flat deposit action. Present when caller needs to transfer funds using returned instructions.

​
destination_amount
object

Destination amount breakdown when returned by provider.

​
next_action
object

Optional hint for additional follow-up action in future multi-step flows.

​
provider_fields
object

Provider-specific raw attributes for advanced integrations.

​
sign_prebuilt_tx
object

Flat signing action. Present when caller must sign and broadcast a prepared transaction.