List payment methods - Tied

GET

/

api

/

v1

/

accounts

/

{account_id}

/

billing

/

payment_methods

List payment methods

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

import requests

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

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/payment_methods', 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/payment_methods")

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/payment_methods"

	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))

}

{
  "schema_version": "1",
  "account_id": 1,
  "payment_methods": [],
  "default_payment_method_id": null,
  "auto_top_up_ready": false,
  "freshness": {
    "source": "stripe",
    "as_of": "2026-09-21T04:24:40Z",
    "state": "fresh"
  }
}

{
  "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

schema_version

string

Version of this payload's shape.

account_id

integer

The account.

payment_methods

object[]

Cards on file, as the payment provider describes them — brand, last four, expiry.

default_payment_method_id

string | null

Which one is charged by default.

auto_top_up_ready

boolean

Whether there is a usable card for automatic top-ups. This is the field to check before offering the setting.

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

List payment methods

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

import requests

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

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/payment_methods', 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/payment_methods")

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/payment_methods"

	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))

}

{
  "schema_version": "1",
  "account_id": 1,
  "payment_methods": [],
  "default_payment_method_id": null,
  "auto_top_up_ready": false,
  "freshness": {
    "source": "stripe",
    "as_of": "2026-09-21T04:24:40Z",
    "state": "fresh"
  }
}

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