Skip to content

List Accounts

Endpoint

http
GET /unified/ads/accounts
Integrations supported
  • Google Ads
  • Meta Marketing API

Query parameters

Refer Specifying query parameters in Truto APIs

integrated_account_id
string · uuid
REQUIRED · 

The ID of the integrated account to use for the request.

Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_format
string

The format of the response.

  • unified will return the response with unified mappings applied.
  • raw will return the raw response from the remote API.
  • normalized will apply the unified mappings and return the data in a normalized format.

Defaults to unified.

All possible enum values:
  • unified
  • raw
  • normalized
Example: unified
truto_key_by
string

By default the result attribute is an array of objects. This parameter allows you to specify a field in each result objects to use as key, which transforms the result array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.

Example: id
truto_ignore_limit
boolean

Ignores the limit query parameter.

truto_ignore_remote_data
boolean

Excludes the remote_data attribute from the response.

truto_exclude_fields
array

Array of fields to exclude from the response.

Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_query
object

Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.

Example: remote_query[foo]=bar

Response Body

result
object[]

List of Accounts

id
string
REQUIRED · 

The unique identifier for the account.

Supported in
  • Google Ads
  • Meta Marketing API
name
string

The name of the account.

Supported in
  • Google Ads
  • Meta Marketing API
currency_code
string

The currency code for the account.

Supported in
  • Google Ads
  • Meta Marketing API
status
string

The status of the account.

All possible enum values:
  • active
  • inactive
Supported in
  • Google Ads
  • Meta Marketing API
timezone
object

The timezone for the account.

Supported in
  • Google Ads
  • Meta Marketing API
id
string

The unique identifier for the timezone.

name
string

The name of the timezone.

type
string[]

The type of the account.

Supported in
  • Google Ads
All possible enum values:
  • test
  • manager
spend
object

The spend for the account.

Supported in
  • Meta Marketing API
max_cap
string

The cap amount for the account.

min_cap
string

The min amount for the account.

max_shared_cap
string

The max shared cap for the account.

min_shared_cap
string

The min shared cap for the account.

spent
string

The spend amount for the account.

balance
string

The balance for the account.

daily_budget
string

The daily budget for the account.

disable_reason
string

The reason the account is disabled.

Supported in
  • Meta Marketing API
created_at
string · date-time

The date and time the account was created.

Supported in
  • Meta Marketing API
updated_at
string · date-time

The date and time the account was last updated.

remote_data
object

Raw data returned from the remote API call.

next_cursor
string

The cursor to use for the next page of results. Pass this value as next_cursor in the query parameter in the next request to get the next page of results.