GET accounts

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

Resource URL

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

Resource Information

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

Parameters

Name Required Description Default Value Example
with_deleted optional Include deleted results for 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

Example Response

{
  "request": {
    "params": {
    }
  },
  "data": [
    {
      "name": "The Barista Bar",
      "timezone": "America/Los_Angeles",
      "timezone_switch_at": "2013-05-22T07:00:00Z",
      "id": "abcd",
      "created_at": "2011-11-15T17:22:21Z",
      "salt": "ac07444ff040286537d3f72dba76367c",
      "updated_at": "2016-09-30T21:22:24Z",
      "approval_status": "ACCEPTED",
      "deleted": false,
      "business_id": “abcd”,
      "business_name": “Test Business”
    },
    {
      "name": "Some Company",
      "timezone": "America/Los_Angeles",
      "timezone_switch_at": "2013-05-22T07:00:00Z",
      "id": "defg",
      "created_at": "2011-11-14T21:26:54Z",
      "salt": "5cbdfa6c36c9500a39f2ace18b90fae2",
      "updated_at": "2016-09-30T21:22:24Z",
      "approval_status": "ACCEPTED",
      "deleted": false,
      "business_id": null,
      "business_name": null
    },
     ],
  "data_type": "account",
  "Total_count": 2,
  "next_cursor": null
}