---
title: "Read an existing AdAccount."
method: GET
path: "/cm/v1/ad-accounts/{ad_account_id}"
tags: ["AdAccount"]
---

# Read an existing AdAccount.

`GET /cm/v1/ad-accounts/{ad_account_id}`

Read an existing AdAccount.

## Path parameters

- `ad_account_id` string, required

## Response `200`

A successful response.

- MessagesReadAdAccountResponse
  - `ad_account` DspAdAccount — AdAccount represents a person or organization who owns Products and aims to promote the Products with advertising Campaigns.
    - `id` string — Unique identifier of the AdAccount. Automatically set by server on creation.
    - `title` string, required — A descriptive name of the AdAccount.
    - `description` string — An optional description of the AdAccount.
    - `timezone` string — [IANA timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) name. e.g. America/Los_Angeles.
    - `currency` 'UNKNOWN_CURRENCY' | 'USD' | 'KRW' | 'JPY' | 'EUR' | 'GBP' — Enumeration of currencies supported by Moloco Ads. This value is not part of the specification. - USD: US Dollar. - KRW: Korean Won. - JPY: Japanese Yen. - EUR: EU Euro. - GBP: British Pound.
    - `custom_key_values` object — Custom key/values managed by the Moloco Ads client platform. It's up to the client ads platform to define the schema for the values and their optionality. The keys are recommended, but not required, to be prefixed with the reversed internet domain of the AdCloud client platform company. For example, keys defined by the client ads platform company "example.com" should have "com.example." as the prefix. For complex values, JSON payload is recommended. Moloco doesn't interpret these data in any way for ads serving. Upon serving, the custom key/values in the AdAccount, Campaign, and Creative models will be combined into the serving Creative proto in the order of precedence, with Creative's value having the highest precedence on the same key.
    - `billing_account_id` string — BillingAccount to be applied by default.
    - `created_at` string, date-time — Created time.
    - `updated_at` string, date-time — Last updated time. Should not modify on the client side.
    - `targets_future_preferences` object — targets_future_preferences maps each target_id to corresponding TargetFuturePreferenceInfo.

## Other responses

- `default` — Error. Detailed cause can be found in the `details` field.

---

[API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/revisions/5c85d0910ac0/schema)