GET accounts/:account_id/funding_instruments

Retrieve some or all funding instruments associated with the account specified in the path.

Resource URL

https://ads-api.twitter.com/1/accounts/:account_id/funding_instruments

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes

Parameters

Name Required Description Default Value Example
account_id required The identifier for the leveraged account. Appears within the resource’s path and is generally a required parameter for all Advertising API requests excluding GET accounts . The specified account must be associated with the authenticating user.   43853bhii879
funding_instrument_ids optional Scope the response to just the desired funding instruments by specifying a comma-separated list of identifiers. Up to 50 ids may be provided.   43853bhii885,43853bhii87d,43853bhii89x
with_deleted optional Include deleted results in your request. Defaults to false.   true
sort_by optional Sorts by supported attribute in ascending or descending order. See Sorting for more information.   created_at-asc updated_at-desc

Example Request

GET https://ads-api.twitter.com/1/accounts/18ce54ayf0z/funding_instruments?with_deleted=true

Example Response

{
    "request": {
        "params": {
            "with_deleted": true,
            "account_id": "18ce54ayf0z"
        }
    },
    "data": [
        {
            "start_time": "2016-04-07T14:40:28Z",
            "description": "Visa ending in 1234",
            "credit_limit_local_micro": 1000000000,
            "end_time": null,
            "cancelled": false,
            "id": "kvk7o",
            "paused": false,
            "account_id": "18ce54ayf0z",
            "reasons_not_able_to_fund": [],
            "io_header": null,
            "currency": "USD",
            "funded_amount_local_micro": 0,
            "created_at": "2016-04-07T14:40:28Z",
            "type": "CREDIT_CARD",
            "able_to_fund": true,
            "updated_at": "2016-04-07T14:40:28Z",
            "credit_remaining_local_micro": null,
            "deleted": false
        },
        {
            "start_time": "2016-02-24T15:00:00Z",
            "description": "IO",
            "credit_limit_local_micro": null,
            "end_time": "2016-12-31T14:59:59Z",
            "cancelled": false,
            "id": "a12bc",
            "paused": false,
            "account_id": "18ce54ayf0z",
            "reasons_not_able_to_fund": [],
            "io_header": "T123456",
            "currency": "USD",
            "funded_amount_local_micro": 1000000000,
            "created_at": "2016-02-23T01:03:21Z",
            "type": "INSERTION_ORDER",
            "able_to_fund": true,
            "updated_at": "2016-02-23T01:03:21Z",
            "credit_remaining_local_micro": null,
            "deleted": false
        }
    ],
    "data_type": "funding_instrument",
    "total_count": 2,
    "next_cursor": null
}