Get spend caps - Tied

GET

/

api

/

v1

/

accounts

/

{account_id}

/

billing

/

spend_caps

Get spend caps

curl --request GET \
  --url https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps \
  --header 'api_access_token: <api-key>'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps"

headers = {"api_access_token": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps")

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

request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps"

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

	req.Header.Add("api_access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "configuration": {
    "daily_cents": 10000,
    "weekly_cents": 50000,
    "monthly_cents": 150000
  },
  "freshness": {
    "source": "postgres_override",
    "as_of": "2026-09-21T04:24:40Z",
    "state": "fresh"
  },
  "eligibility": {
    "eligible": true
  },
  "dunning_state": null,
  "pending": false,
  "error": null,
  "configuration_digest": "EXAMPLE"
}

{
  "error": "Resource could not be found"
}

Authorizations

api_access_token

string

header

required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

id

integer

required

The numeric ID of the account

Response

Success

The shape every billing control returns: the current values, where they were read from, whether the account may change them, and the digest that guards the next write.

configuration

object

The current settings.

freshness

object

Where this answer came from and how current it is. Billing reads several systems, so every response says which one it used — treat state other than fresh as a reason to be careful with the numbers rather than a failure.

Show child attributes

eligibility

object

Whether this account can use the control, and why not when it cannot.

dunning_state

string | null

Set when the account is in collections, which restricts some controls.

pending

boolean

True while a previous change is still being applied at the provider.

limits

object

Accepted bounds for each amount, where the control has them.

error

object | null

Set when the control could be read but something is wrong with it.

configuration_digest

string

Fingerprint of the current configuration. Send it back as expected_digest when you write, and a 409 means someone changed it first.

Get spend caps

curl --request GET \
  --url https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps \
  --header 'api_access_token: <api-key>'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps"

headers = {"api_access_token": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps")

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

request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/billing/spend_caps"

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

	req.Header.Add("api_access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "configuration": {
    "daily_cents": 10000,
    "weekly_cents": 50000,
    "monthly_cents": 150000
  },
  "freshness": {
    "source": "postgres_override",
    "as_of": "2026-09-21T04:24:40Z",
    "state": "fresh"
  },
  "eligibility": {
    "eligible": true
  },
  "dunning_state": null,
  "pending": false,
  "error": null,
  "configuration_digest": "EXAMPLE"
}

{
  "error": "Resource could not be found"
}