---
title: "Searching airchecks"
method: GET
path: "/airchecks"
---

# Searching airchecks

`GET /airchecks`

This version of the aircheck API does not support the following features for searching and filtering processed airchecks:

* Searching for promo codes in the creative body

To take advantage of these and other advanced features, you must continue to use the normal aircheck dashboard at https://app.magellan.ai/airchecks.

## Query parameters

- `brand_name` string, required
- `start_date` string, date, required
- `end_date` string, date, required
- `podcast_title` string
- `aircheck_statuses` string[]
- `aircheck_tags` string[]
- `feed_types` string[]
- `regions` string[]
- `aircheck_uids` string[]

## Response `200`

200

- object[]
  - `status` 'waiting' | 'found' | 'no_episodes' | 'missing'
  - `run_of_network` boolean
  - `uid` string, nullable
  - `capture_window` 'on' | 'week_of' | 'month_of'
  - `media_types` string[]
  - `region` string
  - `dynamic_insertion` boolean
  - `publishers` string[]
  - `expected_ad_positions` string[]
  - `expected_ad_length` integer, nullable
  - `expected_promo_code` string, nullable
  - `podcast_title` string
  - `brand_name` string
  - `expected_date` string
  - `start_date` string
  - `end_date` string
  - `itunes_id` integer, nullable
  - `aliases` object
    - `brand` string[]
    - `podcast` string[]
    - `network` string[]
  - `matching_ads` object[]
    - `guid` string, uuid
    - `link` string
    - `audio_clip` string
    - `status` 'matched' | 'bonus' | 'wrong_position' | 'ad_length_not_met'
    - `tags` string[]
    - `media_type_source` 'podcast' | 'youtube'
    - `total_ads` object
      - `pre` integer
      - `mid` integer
      - `post` integer
    - `impressions` object
      - `total` integer, nullable
      - `within_capture_window` integer, nullable
    - `youtube_views` object
      - `count` integer, nullable
      - `as_of` string, date, nullable
    - `promo_code` object
      - `found` boolean
      - `actual_codes` string[]
      - `usage_count` integer
    - `competitive_brands_flagged` string[]
    - `ad_stacking` object
      - `stack_position` integer, nullable
      - `stack_size` integer, nullable
    - `brand_safety` object
      - `flagged` boolean
      - `link_to_transcript` string, nullable
      - `keyword_buckets_matched` string[]
    - `episode_title` string
    - `publication_date` string, date-time
    - `download_date` string, date-time
    - `start_time` string, time
    - `end_time` string, time
    - `ad_length` integer
    - `ad_position` 'pre_roll' | 'mid_roll' | 'post_roll'
    - `ad_position_percentage` string
    - `ad_position_quarter` 1 | 2 | 3 | 4
    - `transcription` string

## Other responses

- `400` — 400
- `404` — 404

---

[API](https://skmtc.net/magellan/apis/magellan-ai-api.md) · [All operations](https://skmtc.net/magellan/apis/magellan-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magellan/magellan-ai-api/revisions/a5681791212b/schema)