---
updatedAt: 2026-06-08T03:35:06.000Z
agentTools:
  projectIndex: https://developer.moloco.cloud/llms.txt
---

# Read an existing AdAccount.

Read an existing AdAccount.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Moloco Ads Campaign Management API",
    "description": "Moloco Ads Campaign Management API provides functionalities for Moloco Ads Campaigns.",
    "version": "1.10",
    "contact": {
      "name": "Moloco Inc.",
      "url": "https://www.moloco.com"
    }
  },
  "paths": {
    "/cm/v1/ad-accounts/{ad_account_id}": {
      "get": {
        "summary": "Read an existing AdAccount.",
        "description": "Read an existing AdAccount.",
        "operationId": "DspApi_ReadAdAccount",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesReadAdAccountResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error. Detailed cause can be found in the `details` field.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesReadAdAccountError"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "ad_account_id",
            "description": "The ID of the AdAccount to be retrieved.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "AdAccount"
        ]
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "servers": [
    {
      "url": "https://api.moloco.cloud"
    }
  ],
  "components": {
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "AdAccountTargetFuturePreferenceInfo": {
        "type": "object",
        "properties": {
          "product_scope": {
            "$ref": "#/components/schemas/TargetFuturePreferenceInfoProductScope"
          },
          "custom_products": {
            "$ref": "#/components/schemas/TargetFuturePreferenceInfoCustomProducts"
          }
        },
        "description": "TargetFuturePreferenceInfo contains each target's future preference information.\nIf the newly created Campaign satisfies the condition of target future preference info\nthe target will be automatically assigned to that Campaign."
      },
      "TargetFuturePreferenceInfoCustomProducts": {
        "type": "object",
        "properties": {
          "product_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "description": "CustomProducts stores Products' ids of which the target prefers."
      },
      "TargetFuturePreferenceInfoProductScope": {
        "type": "string",
        "enum": [
          "UNKNOWN",
          "ALL",
          "ANDROID",
          "IOS"
        ],
        "default": "UNKNOWN",
        "description": "ProductScope indicates the scope of Product of which the target prefers."
      },
      "adcloudcommonCurrency": {
        "type": "string",
        "enum": [
          "UNKNOWN_CURRENCY",
          "USD",
          "KRW",
          "JPY",
          "EUR",
          "GBP"
        ],
        "default": "UNKNOWN_CURRENCY",
        "description": "Enumeration of currencies supported by Moloco Ads.\n\nThis value is not part of the specification.\n\n - USD: US Dollar.\n - KRW: Korean Won.\n - JPY: Japanese Yen.\n - EUR: EU Euro.\n - GBP: British Pound."
      },
      "dspAdAccount": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the AdAccount. Automatically set by server on creation."
          },
          "title": {
            "type": "string",
            "description": "A descriptive name of the AdAccount."
          },
          "description": {
            "type": "string",
            "description": "An optional description of the AdAccount."
          },
          "timezone": {
            "type": "string",
            "description": "[IANA timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) name.\ne.g. America/Los_Angeles."
          },
          "currency": {
            "$ref": "#/components/schemas/adcloudcommonCurrency"
          },
          "custom_key_values": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Custom key/values managed by the Moloco Ads client platform.\nIt's up to the client ads platform to define the schema for the values and their optionality.\n\nThe keys are recommended, but not required, to be prefixed with the reversed\ninternet domain of the AdCloud client platform company. For example, keys defined\nby the client ads platform company \"example.com\" should have \"com.example.\" as\nthe prefix.\n\nFor complex values, JSON payload is recommended.\n\nMoloco doesn't interpret these data in any way for ads serving.\nUpon serving, the custom key/values in the AdAccount, Campaign,\nand Creative models will be combined into the serving Creative proto in the order of precedence,\nwith Creative's value having the highest precedence on the same key."
          },
          "billing_account_id": {
            "type": "string",
            "description": "BillingAccount to be applied by default."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Created time.",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last updated time. Should not modify on the client side."
          },
          "targets_future_preferences": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/AdAccountTargetFuturePreferenceInfo"
            },
            "description": "targets_future_preferences maps each target_id to corresponding TargetFuturePreferenceInfo."
          }
        },
        "description": "AdAccount represents a person or organization\nwho owns Products and aims to promote the Products with advertising Campaigns.",
        "required": [
          "title"
        ]
      },
      "messagesReadAdAccountError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "details": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/messagesReadAdAccountErrorAPIErrorInfo"
            }
          }
        }
      },
      "messagesReadAdAccountErrorAPIErrorInfo": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/messagesReadAdAccountErrorAPIErrorInfoErrorReason"
          },
          "error_log_id": {
            "type": "string"
          },
          "context": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "messagesReadAdAccountErrorAPIErrorInfoErrorReason": {
        "type": "string",
        "enum": [
          "ERROR_REASON_UNKNOWN"
        ],
        "default": "ERROR_REASON_UNKNOWN"
      },
      "messagesReadAdAccountResponse": {
        "type": "object",
        "properties": {
          "ad_account": {
            "$ref": "#/components/schemas/dspAdAccount",
            "description": "The retrieved AdAccount data."
          }
        }
      }
    }
  }
}
```