---
title: "List ad accounts"
method: GET
path: "/v2/ad_accounts"
tags: ["Ad Accounts"]
---

# List ad accounts

`GET /v2/ad_accounts`

## Request

- Base URL: `https://api.tenjin.com`
- URL: `https://api.tenjin.com/v2/ad_accounts`
- Auth: HTTP bearer

## Query parameters

- `channel_id` integer
- `query` string
- `page` integer
- `per_page` integer

## Response `200`

Ad accounts

- AdAccountListDocument
  - `data` AdAccountResource[], required
    - `id` string, uuid, required
    - `type` 'ad_account', required
    - `attributes` object, required
      - `name` string, required: Name of the ad account
      - `channel_id` integer, required: Id of the ad account's channel
      - `external_id` string, nullable, required: Id of the account on the ad network
  - `links` Links, required
    - `self` string, uri, required: URL of this request
    - `first` string, uri: URL of the first page of a list
    - `prev` string, uri: URL of the previous page of a list
    - `next` string, uri: URL of the next page of a list
    - `last` string, uri: URL of the last page of a list
  - `meta` PageMeta, required
    - `count` integer, required: Number of items on all pages
    - `per_page` integer, required: Number of items per page

## Other responses

- `400`: A param is missing or invalid, a record is not found, or the request cannot be served
- `401`: Missing or invalid credentials, or no access to the requested data
- `403`: Invalid token, or the user's role does not allow the request
- `498`: Expired token, or a token with an invalid signature

---

[API](https://skmtc.dev/tenjin/apis/campaign-management-api.md) - [All operations](https://skmtc.dev/tenjin/apis/campaign-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tenjin/apis/campaign-management-api/revisions/e3cae1a03a92?raw)