Google Ads
Accounts
GET
Retrieve Google Ads account information and budget details.
This endpoint returns account-level data including customer information, account status, currency, timezone, and budget configurations.
Dimensions Available:
- Customer resource name, customer ID, descriptive name
- Currency code, timezone, status
- Account budget details: resource name, status, billing setup, spending limits
Limitations:
- Maximum 5000 records per page
- Default page size: 500
- Supports pagination
Filters:
organizationId(required)userId(optional)integrationName(optional)
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringOrganization identifier (required)
userId?stringUser identifier (optional)
integrationName?stringIntegration name identifier (optional)
page?integerPage number for pagination (optional)
Default
1limit?integerNumber of items per page (optional, max 5000)
Range
value <= 5000Default
500Successful response
application/json- response
data?array<>meta?curl -X GET "https://example.com/v1/google/accounts?organizationId=organization_123"{ "data": [ { "customer_resource_name": "string", "customer_id": "string", "customer_descriptive_name": "string", "customer_currency_code": "string", "customer_time_zone": "string", "customer_status": "string", "account_budget_resource_name": "string", "account_budget_status": "string", "account_budget_proposed_end_time_type": "string", "account_budget_approved_end_time_type": "string", "account_budget_id": "string", "account_budget_billing_setup": "string", "account_budget_name": "string", "account_budget_proposed_start_date_time": "2019-08-24T14:15:22Z", "account_budget_approved_start_date_time": "2019-08-24T14:15:22Z", "account_budget_proposed_spending_limit": 0, "account_budget_approved_spending_limit": 0, "account_budget_adjusted_spending_limit": 0, "organization_id": "string", "user_id": "string", "document_id": "string", "integration_name": "string", "inserted_at": "2019-08-24T14:15:22Z" } ], "meta": { "page": 0, "limit": 0, "hasNextPage": true, "hasPreviousPage": true }}