Skip to main content
Every advertiser organization has exactly one default ad account. It is the parent scope for all of your campaigns and the account the Thrad Platform charges. This endpoint returns that account so you can confirm scope, currency, and timezone before creating campaigns.
The ad account is read-only over the API. There is no create, update, or list operation — an organization always has a single default account, provisioned for you in the Thrad Platform dashboard.

​
Authorizations

​
Authorization
string
required
Bearer token using your organization’s API key: Authorization: Bearer ak_.... There is one active key per organization — create or rotate it in the Thrad Platform dashboard under Settings → API keys. Store it as the THRAD_ADS_API_KEY environment variable.

​
Request

GET /v1/ad_account This endpoint takes no path, query, or body parameters. 
curl https://api.thrad.ai/v1/ad_account \
  -H "Authorization: Bearer $THRAD_ADS_API_KEY"

{
  "id": "f3a1c2d4-5b6e-47a8-9c0d-1e2f3a4b5c6d",
  "name": "Acme Inc.",
  "url": "https://acme.com",
  "timezone": "UTC",
  "currency_code": "USD",
  "preview_url": "https://cdn.thrad.ai/assets/acme-logo.png"
}

​
Response

​
id
string
The ad account’s identifier (a UUID). Use this value as ad_account_id when creating a campaign for a non-default account; omit it to target the default account.
​
name
string
Display name of the ad account. May be an empty string if no name is set.
​
url
string
The advertiser’s website URL. Falls back to your organization’s domain when the account has none, and may be an empty string if neither is set.
​
timezone
string
The account timezone. Always "UTC" — all timestamps in the API are Unix seconds interpreted in UTC.
​
currency_code
string
The billing currency. Always "USD".
​
preview_url
string
Optional. A URL to the account’s logo image, returned only when a logo has been set. Absent otherwise.

​
Errors

Errors use the bare error shape — { "error": { "message", "type", "param", "code" } } — not the platform envelope.
StatusTypeCodeWhen
401 Unauthorizedauthentication_errorauth_requiredThe Authorization header is missing entirely.
401 Unauthorizedauthentication_errorinvalid_api_keyThe Authorization: Bearer ak_... key is malformed, unknown, or revoked.
429 Too Many Requestsrate_limit_errorrate_limit_exceededExceeded the per-key limit of 1000 requests/hour.
Money and timestamps elsewhere in this API follow strict conventions: resource budgets and bids are integer micros ($1 = 1,000,000), insights spend figures are dollar floats, and all times are Unix seconds in UTC. The ad account itself exposes none of these — it only confirms timezone is UTC and currency_code is USD.