Get billing methods

curl --request GET \
  --url https://api.snappy.com/public-api/v3/billing-methods \
  --header 'X-Api-Key: <api-key>' \
  --header 'snappy-account-id: <snappy-account-id>'

import requests

url = "https://api.snappy.com/public-api/v3/billing-methods"

headers = {
    "snappy-account-id": "<snappy-account-id>",
    "X-Api-Key": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'snappy-account-id': '<snappy-account-id>', 'X-Api-Key': '<api-key>'}
};

fetch('https://api.snappy.com/public-api/v3/billing-methods', 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://api.snappy.com/public-api/v3/billing-methods",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>",
    "snappy-account-id: <snappy-account-id>"
  ],
]);

$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://api.snappy.com/public-api/v3/billing-methods"

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

	req.Header.Add("snappy-account-id", "<snappy-account-id>")
	req.Header.Add("X-Api-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.snappy.com/public-api/v3/billing-methods")
  .header("snappy-account-id", "<snappy-account-id>")
  .header("X-Api-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snappy.com/public-api/v3/billing-methods")

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

request = Net::HTTP::Get.new(url)
request["snappy-account-id"] = '<snappy-account-id>'
request["X-Api-Key"] = '<api-key>'

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

{
  "data": [
    {
      "id": "6a2515d0982480c2a4fd6b81",
      "name": "Q1 Marketing PO",
      "type": "PO",
      "status": "active",
      "createdAt": "2025-01-15T10:00:00.000Z",
      "expirationDate": "2025-12-31T23:59:59.000Z",
      "spendingLimit": {
        "remaining": 7250.5
      }
    },
    {
      "id": "6a2515d1982480c2a4fd6b82",
      "name": "Net-30 Invoice",
      "type": "Invoice",
      "status": "active",
      "createdAt": "2025-03-01T10:00:00.000Z",
      "expirationDate": null,
      "spendingLimit": null
    }
  ]
}

{
  "status": 400,
  "errorCode": "400_PBLC_001",
  "message": "Bad Request"
}

{
  "status": 401,
  "errorCode": "401_PBLC_001",
  "message": "Unauthorized"
}

{
  "status": 403,
  "errorCode": "403_PBLC_001",
  "message": "Forbidden"
}

{
  "status": 404,
  "errorCode": "404_PBLC_001",
  "message": "Not Found"
}

Billing methods

Get billing methods

Use this endpoint to retrieve the billing methods of an account that are usable through the public API. Use this when you need to discover which billing methods are available - and how much budget remains on each - before placing marketplace orders or triggering gifts.

Filtering options

filter[type] - exact match on billing method type. One of Prepay, Invoice, PO, CC.
filter[status] - exact match on billing method status. Allowed values depend on the type:
- Invoice: active, archived
- CC: active, archived, expired
- PO: draft, active, archived, expired
- Prepay: draft, active, archived
filter[remainingBalance][gte] - return billing methods with a spendingLimit.remaining greater than or equal to this value. Value is in USD dollars and must be greater than 0 (e.g. 1000 = $1,000).
filter[remainingBalance][lte] - return billing methods with a spendingLimit.remaining less than or equal to this value. Value is in USD dollars and must be greater than 0 (e.g. 5000 = $5,000).

Required headers

Snappy-Account-Id - account scope.

Optional headers

Snappy-Company-Id - further scope to a specific Company.

Please note

Express billing methods are intentionally excluded from this endpoint. They exist on some accounts but cannot be used through the public API.
Each billing method’s response includes a spendingLimit object with a remaining balance in USD dollars, or null when the billing method has no cap (e.g. Invoice).
expirationDate is null when no expiry is configured on the billing method.
filter[remainingBalance] filters apply only to billing methods that have a spendingLimit. Invoice billing methods (which have spendingLimit: null) are excluded when either range bound is supplied.

Permissions

Requires: billingMethods:read

GET

billing-methods

Get billing methods

curl --request GET \
  --url https://api.snappy.com/public-api/v3/billing-methods \
  --header 'X-Api-Key: <api-key>' \
  --header 'snappy-account-id: <snappy-account-id>'

import requests

url = "https://api.snappy.com/public-api/v3/billing-methods"

headers = {
    "snappy-account-id": "<snappy-account-id>",
    "X-Api-Key": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'snappy-account-id': '<snappy-account-id>', 'X-Api-Key': '<api-key>'}
};

fetch('https://api.snappy.com/public-api/v3/billing-methods', 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://api.snappy.com/public-api/v3/billing-methods",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>",
    "snappy-account-id: <snappy-account-id>"
  ],
]);

$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://api.snappy.com/public-api/v3/billing-methods"

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

	req.Header.Add("snappy-account-id", "<snappy-account-id>")
	req.Header.Add("X-Api-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.snappy.com/public-api/v3/billing-methods")
  .header("snappy-account-id", "<snappy-account-id>")
  .header("X-Api-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snappy.com/public-api/v3/billing-methods")

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

request = Net::HTTP::Get.new(url)
request["snappy-account-id"] = '<snappy-account-id>'
request["X-Api-Key"] = '<api-key>'

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

{
  "data": [
    {
      "id": "6a2515d0982480c2a4fd6b81",
      "name": "Q1 Marketing PO",
      "type": "PO",
      "status": "active",
      "createdAt": "2025-01-15T10:00:00.000Z",
      "expirationDate": "2025-12-31T23:59:59.000Z",
      "spendingLimit": {
        "remaining": 7250.5
      }
    },
    {
      "id": "6a2515d1982480c2a4fd6b82",
      "name": "Net-30 Invoice",
      "type": "Invoice",
      "status": "active",
      "createdAt": "2025-03-01T10:00:00.000Z",
      "expirationDate": null,
      "spendingLimit": null
    }
  ]
}

{
  "status": 400,
  "errorCode": "400_PBLC_001",
  "message": "Bad Request"
}

{
  "status": 401,
  "errorCode": "401_PBLC_001",
  "message": "Unauthorized"
}

{
  "status": 403,
  "errorCode": "403_PBLC_001",
  "message": "Forbidden"
}

{
  "status": 404,
  "errorCode": "404_PBLC_001",
  "message": "Not Found"
}

Authorizations

X-Api-Key

string

header

required

Company Level Authentication

Include your API key in the X-Api-Key header for every request:

X-Api-Key: YOUR_API_KEY

Headers

snappy-account-id

string

required

Account identifier.

Example:

"acc123456"

snappy-company-id

string

Optional company identifier.

Example:

"cmp123456"

Query Parameters

filter[type]

enum<string>

Filter by billing method type.

Available options:

Prepay,

Invoice,

PO,

CC

Example:

"PO"

filter[status]

enum<string>

Filter by billing method status. Allowed values depend on the selected type.

Available options:

draft,

active,

archived,

expired

Example:

"active"

filter[remainingBalance][gte]

number

Return only billing methods with remaining balance at or above this value.

Required range: x > 0

Example:

1000

filter[remainingBalance][lte]

number

Return only billing methods with remaining balance at or below this value.

Required range: x > 0

Example:

5000

Response

List of billing methods for the account.

A list of billing methods for the account.

data

object[]

required

Show child attributes

Last modified on June 17, 2026

Billing Methods API: Account Funding Sources and Remaining Balances

Get billing method by ID

Authentication

Marketplace

Gifting

Administration

Get billing methods

Permissions

Authorizations

Company Level Authentication

Headers

Query Parameters

Response