GET accounts

Retrieve all of the advertising-enabled accounts the authenticating user has access to.

Note that currency is deprecated from the accounts endpoint. Currency is an attribute at the funding instrument level, not the account level.

Resource URL

https://ads-api.twitter.com/0/accounts

Resource Information

Response formats

JSON

Requires authentication?

Yes (user context only)

Rate limited?

Yes

Parameters

with_deleted optional

Include deleted results in your request. Defaults to false.

Example Values: true

sort_byoptional

Sorts by supported attribute in ascending or descending order.

Example Values: created_at, updated_at, deleted

Learn more about Sorting.

OAuth Signature Generator

Example Request

GET 
https://ads-api.twitter.com/0/accounts

Example Result

  {
    "data": [
        {
            "approval_status": "ACCEPTED",
            "created_at": "2012-11-28T22:38:43Z",
            "deleted": false,
            "id": "defg",
            "name": "Some company",
            "salt": "3ae83290ccd1831d9c867eddd96c8d6c",
            "timezone": "America/Los_Angeles",
            "timezone_switch_at": "2014-07-28T07:00:00Z",
            "updated_at": "2014-10-06T17:43:31Z"
        },
        {
            "approval_status": "ACCEPTED",
            "created_at": "2014-07-14T22:51:48Z",
            "deleted": false,
            "id": "abcd",
            "name": "Some person named Emma",
            "salt": "973fef8ecb1c5d5f6bba4b61827c214a",
            "timezone": "America/Los_Angeles",
            "timezone_switch_at": "2014-07-27T07:00:00Z",
            "updated_at": "2014-08-27T21:59:56Z"
        }
    ],
    "data_type": "account",
    "next_cursor": null,
    "request": {
        "params": {}
    },
    "total_count": 2
}