Skip to main content

Funding Sources

An Funding Source is owned by an Organization and defines the financial instrument/terms responsible for the ad spend. Funding sources are assigned to an Ad Account in order to pay for the activity within that Ad Account.

Attributes

AttributeDescriptionPossible ValuesSupported for type
idID of the funding sourceALL
created_atDate of creationALL
updated_atDate of last updateALL
typeFunding Source typeLINE_OF_CREDIT, CREDIT_CARD, COUPON, PAYPALALL
statusStatus of the funding sourceACTIVE, REDEEMED, SPENT, EXPIRED, DELETEDALL
budget_spent_microBudget Spent (micro-currency)LINE_OF_CREDIT
currencyAccount currencyUSD, CAD, GBP, AUD, EURLINE_OF_CREDIT, COUPON
total_budget_microTotal Budget (micro-currency)LINE_OF_CREDIT, CREDIT_CARD
budget_spent_microBudget spent (micro-currency)LINE_OF_CREDIT, CREDIT_CARD
available_credit_microTotal available creditLINE_OF_CREDIT, COUPON
card_typeCredit Card TypeAMEX, DINERS_CLUB, DISCOVER, JCB, MAESTRO, MASTERCARD, VISA, UNKNOWNCREDIT_CARD
nameName of the Credit CardALL
last_4Last 4 digits of the Credit CardCREDIT_CARD
expiration_yearExpiration year of the Credit CardCREDIT_CARD
expiration_monthExpiration month of the Credit CardCREDIT_CARD
daily_spend_limit_microDaily spend limit for Credit Card (micro-currency)CREDIT_CARD
daily_spend_limit_currencyCurrency for the daily_spend_limit_microUSD, CAD, GBP, AUD, EURCREDIT_CARD
value_microValue of the COUPON (micro-currency)COUPON
start_dateStart date of the COUPONCOUPON
end_dateEnd date of the COUPONCOUPON
emailEmail associated with PaypalPAYPAL

Create a Funding Source

Funding sources using credit cards and PayPal can be set up using Business Manager

The Partner Manager team creates all other types of Funding Sources on behalf of partners and advertisers. Please reach out to your partner manager for assistance.

Get All Funding Sources

curl "https://adsapi.snapchat.com/v1/organizations/{organization_id}/fundingsources" \
-H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
"request_status": "SUCCESS",
"request_id": "59236a2500ff05763ff95f2fcc0001737e7465616d6b6f363139000161646d616e616765722d6170693a6b6162726168616d0001011d",
"fundingsources": [
{
"sub_request_status": "SUCCESS",
"fundingsource": {
"id": "1e224e75-3883-42cf-a5d9-ce505945d2d3",
"updated_at": "2017-05-22T22:46:30.917Z",
"created_at": "2017-05-22T22:46:30.917Z",
"type": "CREDIT_CARD",
"card_type": "DISCOVER",
"name": "My DISCOVER card",
"last_4": "1100",
"expiration_month": "12",
"expiration_year": "2020",
"daily_spend_limit_micro": 25000000,
"daily_spend_currency": "USD"
}
},
{
"sub_request_status": "SUCCESS",
"fundingsource": {
"id": "9d111fbf-da5f-4526-9e7b-226f847b3d7e",
"updated_at": "2017-05-22T22:46:30.920Z",
"created_at": "2017-05-22T22:46:30.920Z",
"type": "LINE_OF_CREDIT",
"available_credit_micro": 2000000000,
"currency": "USD",
"total_budget_micro": 10000000000,
"status": "ACTIVE",
"credit_account_type": "MANAGED",
"budget_spent_micro": 8000000000
}
},
{
"sub_request_status": "SUCCESS",
"fundingsource": {
"id": "d24b4011-3560-47ea-86fa-0ed14c6b90d4",
"updated_at": "2017-05-22T22:46:30.920Z",
"created_at": "2017-05-22T22:46:30.920Z",
"type": "COUPON",
"available_credit_micro": 10000000000,
"currency": "EUR",
"value_micro": 10000000000,
"status": "REDEEMED",
"start_date": "2017-05-22T22:46:30.923Z",
"end_date": "2017-05-22T22:46:30.923Z"
}
}
]
}

This endpoint retrieves all funding sources for the specified Organization.

HTTP Request

GET https://adsapi.snapchat.com/v1/organizations/{organization_id}/fundingsources

Parameters

ParameterDefaultDescription
organization_idOrganization ID

Get a Specific Funding Source

curl "https://adsapi.snapchat.com/v1/fundingsources/e703eb9f-8eac-4eda-a9c7-deec3935222d" \
-H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
"request_status": "success",
"request_id": "57b000ffd800ff05551a197221f10001737e616473617069736300016275696c642d35396264653638322d312d31312d370001010c",
"fundingsources": [
{
"sub_request_status": "success",
"fundingsource": {
"id": "e703eb9f-8eac-4eda-a9c7-deec3935222d",
"updated_at": "2016-08-11T22:03:54.337Z",
"created_at": "2016-08-11T22:03:54.337Z",
"name": "Hooli Test Ad Account Funding Source",
"type": "LINE_OF_CREDIT",
"organization_id": "40d6719b-da09-410b-9185-0cc9c0dfed1d",
"currency": "USD"
}
}
]
}

This endpoint retrieves a specific funding source.

HTTP Request

GET https://adsapi.snapchat.com/v1/fundingsources/{funding_source_id}

URL Parameters

ParameterDescription
funding_source_idThe ID of the funding source to retrieve
Was this page helpful?
Yes
No

AI-Powered Search