Skip to main content
GET
/
v2
/
collections
/
budgets
Get collection budgets
curl --request GET \
  --url https://api.snappy.com/public-api/v2/collections/budgets \
  --header 'X-Api-Key: <api-key>'
{
  "results": [
    {
      "min": 15,
      "max": 25
    },
    {
      "min": 26,
      "max": 50
    },
    {
      "min": 51,
      "max": 100
    },
    {
      "min": 101,
      "max": 200
    },
    {
      "min": 201,
      "max": 500
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

Company Level Authentication

Company level authentication provides access to all resources under your company, including accounts, campaigns, gifts, and recipients.

Getting Your API Key

  1. Create an API Key: Use the POST /v2/authentication/apiKeys endpoint to generate a new API key
  2. Set Expiration: Choose from 30, 60, 90, or 180 days (default: 90 days)
  3. Optional mTLS: Enable mutual TLS for enhanced security
  4. Name Your Key: Provide a descriptive name for easy identification

Using Your API Key

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

X-Api-Key: YOUR_24_CHARACTER_API_KEY

API Key Management

  • Maximum Keys: Up to 3 active API keys per company
  • Rotation: Delete old keys before creating new ones when at the limit
  • Security: Keys are hashed and cannot be retrieved after creation

Enhanced Security (mTLS)

For production environments, enable mutual TLS authentication:

  1. Set enforceMtls: true when creating the API key
  2. Contact support to obtain your client certificates
  3. Use the mTLS endpoint: https://mtls-api.snappy.com/public-api

Headers

​
Request-Source
enum<string>

Source of the request

Available options:
api_native,
api_zapier,
api_salesforce,
api_ftp,
api_make
Example:

"api_native"

Query Parameters

​
type
enum<string>
required

Collection type

Available options:
swag,
gifts,
local experiences,
custom
Example:

"swag"

​
companyId
string

Company ID

Pattern: ^[A-Za-z0-9]{8,}$
Example:

"12345678"

​
accountId
string

Account ID

Example:

"a12bcd34"

​
countries
string[]

List of supported countries

Minimum array length: 1
Example:
["US"]
​
collectionId
string

The collection ID

Pattern: ^[A-Za-z0-9]{8,}$
Example:

"abcdef12"

Response

Successful response

Response containing available budget ranges for collections.

​
results
object[]
required

The fetched budgets.

Last modified on June 2, 2026