---
title: "Get Company Meta Ads"
method: GET
path: "/companies/{company_id}/meta-ads"
tags: ["companies"]
---

# Get Company Meta Ads

`GET /companies/{company_id}/meta-ads`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/meta-ads`
- Auth: HTTP bearer

The Ads-panel DTO (polled). Hidden client-side when ineligible; never mints a Stripe URL.

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- MetaAdsPanelResponse
  - `eligible` boolean, required
  - `ads_billing_acknowledged` boolean, required
  - `has_campaign` boolean, required
  - `status` string, nullable, required
  - `creative_status` string, required
  - `daily_cap_usd` number, required
  - `min_daily_cap_usd` number, required
  - `max_daily_cap_usd` number, required
  - `primary_text` string, nullable, required
  - `headline` string, nullable, required
  - `cta_type` string, nullable, required
  - `destination_url` string, nullable, required
  - `target_countries` string[], required
  - `pending_target_countries` string[]
  - `thumbnail_url` string, nullable, required
  - `stats` MetaAdsStats, required
    - `ctr` number, nullable, required
    - `cpm` number, nullable, required
    - `cpc` number, nullable, required
    - `clicks` integer, required
    - `impressions` integer, required
    - `spend_7d_usd` number, required
    - `spend_lifetime_usd` number, required
  - `charged_today_usd` number, required
  - `prepaid_buffer_usd` number, required
  - `insufficient_credits` boolean, required
  - `not_delivering` boolean, required
  - `generation_error` string, nullable, required
  - `launch_queue_ahead` integer, nullable, required
  - `ad_rejected` boolean, required
  - `policy_blocked_vertical` string, nullable, required
  - `creative_generated_at` string, date-time, nullable, required
  - `creative_source` 'agent' | 'owner_copy' | 'platform', nullable, required
  - `daily_cap_set_by` 'owner' | 'agent', nullable, required
  - `daily_cap_set_at` string, date-time, nullable, required
  - `last_synced_at` string, date-time, nullable, required
  - `estimated_take_cost_credits` number, required
  - `open_proposal` MetaAdsOpenProposal, required
    - `id` string, required
    - `to_usd` number, required
    - `reason` string, required
    - `created_at` string, date-time, required
  - `regenerations_left_today` integer, required
  - `direction_doc_exists` boolean, required
  - `site_language` string, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-24** `13ab52219355`: 1 info
  - added the optional property `pending_target_countries` to the response with the `200` status
- **2026-09-11** `97b262b63810`: 10 info
  - added the required property `creative_generated_at` to the response with the `200` status
  - added the required property `creative_source` to the response with the `200` status
  - added the required property `daily_cap_set_at` to the response with the `200` status
  - added the required property `daily_cap_set_by` to the response with the `200` status
  - …6 more

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/meta-ads/get.md)

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) - [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/291bb76b720b?raw)