Skip to main content
GET
/
spend_controls
List Spend Controls
curl --request GET \
  --url https://api-sandbox.synctera.com/v0/spend_controls \
  --header 'Authorization: Bearer <token>'
{
  "spend_controls": [
    {
      "number_of_related_accounts": 1,
      "action_case": true,
      "action_decline": true,
      "amount_limit": 1,
      "creation_time": "2010-05-06T12:23:34.321Z",
      "direction": "CREDITS",
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "is_active": true,
      "last_modified_time": "2010-05-06T12:23:34.321Z",
      "merchant_category_codes": [
        "5600–5699"
      ],
      "name": "<string>",
      "payment_sub_types": [
        "ACH.INCOMING_CREDIT"
      ],
      "payment_types": [
        "ACH"
      ],
      "time_range": {
        "time_range_type": "ROLLING_WINDOW_DAYS"
      }
    }
  ],
  "next_page_token": "a8937a0d"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
amount_limit_gte
integer

return results with an amount limit greater than or equal to this

Required range: x >= 0
​
amount_limit_lte
integer

return results with an amount limit less than or equal to this

Required range: x >= 0
​
num_related_accounts_gte
integer

return results that are associated with at least this many accounts

Required range: x >= 0
​
num_related_accounts
integer

return results that are associated with this many accounts

Required range: x >= 0
​
num_related_accounts_lte
integer

return results that are associated with at most this many accounts

Required range: x >= 0
​
sort_by
enum<string>[]

Specifies the sort order for returned Spend Controls.

​
payment_type
enum<string>

The type of payment to which a spend control applies. If this is not set, the spend control applies to all spending, regardless of payment type.

Available options:
ACH,
CARD,
CASH,
CHECK,
EFT_CA,
EXTERNAL_CARD,
INTERNAL_TRANSFER,
SYNCTERA_PAY,
WIRE
​
name
string

return results that match this name

​
id
string<uuid>[]

return results with these comma-separated IDs

Example:

"c833e6c6-5c15-4719-90e9-7a6682c483d3,ef17356c-69b0-446e-ae2f-72ab59eeb544"

​
direction
enum<string>

The direction of funds flow to which a spend control applies. To limit the rate of funds flowing out of an account, use DEBIT. To limit the rate of funds flowing in to an account, use CREDIT. If this is not set, the spend control applies to debits (ie spending) only.

Available options:
CREDITS,
DEBITS
​
is_active
boolean

return results that match this active status

​
limit
integer
default:100

Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.

Required range: x >= 1
Example:

100

​
account_id
string<uuid>

return results matching this account ID

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
amount_limit
integer

return results matching this amount limit

Required range: x >= 0

Response

Spend control details

​
spend_controls
object[]
required

Array of Spend Controls

​
next_page_token
string

If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

Example:

"a8937a0d"