Get Vault spend usage

curl --request GET \
  --url https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage', 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://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage",
  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: Basic <encoded-value>"
  ],
]);

$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://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "vaultId": "vault_123",
  "status": "active",
  "reason": "Requested by partner",
  "period": "fixed_30_day",
  "periodSeconds": 2592000,
  "supportedAssets": [
    {
      "symbol": "USDC",
      "chainId": 42161,
      "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "decimals": 6
    }
  ]
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication is required"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "The credential does not allow this operation"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The resource was not found"
  }
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "The Idempotency-Key was already used with a different request"
  }
}

{
  "error": {
    "code": "chain_config_missing",
    "message": "The requested network is not configured for this environment"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests"
  }
}

{
  "error": {
    "code": "provider_failure",
    "message": "An upstream service returned an error"
  }
}

GET

accounts

{accountId}

vault

spend-usage

Get Vault spend usage

curl --request GET \
  --url https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage', 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://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage",
  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: Basic <encoded-value>"
  ],
]);

$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://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://prod-api.stableyard.fi/v2/accounts/{accountId}/vault/spend-usage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "vaultId": "vault_123",
  "status": "active",
  "reason": "Requested by partner",
  "period": "fixed_30_day",
  "periodSeconds": 2592000,
  "supportedAssets": [
    {
      "symbol": "USDC",
      "chainId": 42161,
      "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "decimals": 6
    }
  ]
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication is required"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "The credential does not allow this operation"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The resource was not found"
  }
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "The Idempotency-Key was already used with a different request"
  }
}

{
  "error": {
    "code": "chain_config_missing",
    "message": "The requested network is not configured for this environment"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests"
  }
}

{
  "error": {
    "code": "provider_failure",
    "message": "An upstream service returned an error"
  }
}

Returns the Vault’s delegated payment limit, set by the Vault’s on-chain spending policy, with the consumed, pending and currently available amounts, the exact reset time and the supported assets. Pending amounts are Vault payments that are in flight. USDC and USDT consume the same limit. Transfers the Vault owner makes directly do not count against this limit.

Authorizations

Authorization

string

header

required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version

enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:

2026-09-09

Path Parameters

accountId

string

required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Response

Vault spend usage

vaultId

string

required

Example:

"vault_123"

status

enum<string>

required

Available options:

active,

not_active

period

string

required

Allowed value: "fixed_30_day"

periodSeconds

integer

required

supportedAssets

object[]

required

Show child attributes

reason

string

Present when status is not_active.

limitUsdAtomic

string

Pattern: ^[0-9]+$

limitAtomic

string

Pattern: ^[0-9]+$

consumedAtomic

string

Pattern: ^[0-9]+$

onchainConsumedAtomic

string

Pattern: ^[0-9]+$

settledRecordedAtomic

string

Pattern: ^[0-9]+$

pendingAtomic

string

Pattern: ^[0-9]+$

availableAtomic

string

Pattern: ^[0-9]+$

windowStartedAt

string<date-time>

resetsAt

string<date-time>

observedAt

string<date-time>

Introduction

Onboarding

Accounts

Money movement

Activity

Vaults

Client & checkout

Platform

Get Vault spend usage

Authorizations

Headers

Path Parameters

Response