> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Ad Unit Target Detail

> Returns advertiser-safe ad unit detail for allocation target selection (name, description, active status, sizes, enabled ad types, video format — for native format/style mappings use GET /ad-unit-native-styles?ad_unit_id=).



## OpenAPI

````yaml /openapi/adm.openapi.en-dev.json get /api/manager/ad-units/targets/{ad_unit_id}
openapi: 3.1.0
info:
  description: >
    ## Introduction

    The Data Management APIs comprehensively oversees the **diverse data** used
    by advertising and recommendation systems, ensuring that the Decision API
    runs accurately and efficiently.


    From registering, updating, and deleting campaigns and placements to **log
    and statistics analysis**, it provides the insights necessary for effective
    system operation.


    The resulting data and metrics are used by the Decision API to **optimize ad
    and content decisions**, ultimately boosting the overall performance of the
    advertising and recommendation system.
  title: Data Management APIs
  version: dev
servers: []
security: []
tags:
  - description: >-
      Authentication endpoints. All roles (admin, operator, advertiser) use
      these to log in, refresh tokens, and manage their own credentials.
    name: Auth
  - description: >-
      Advertiser account management. Operators and admins onboard advertisers,
      manage their budgets, and deactivate accounts. Advertisers can only read
      their own profile and balance — they cannot create, delete, or modify
      another advertiser's account.
    name: Advertisers
  - description: >-
      Internal user (operator / admin) account management. Admin only. Covers
      creating operator accounts, changing roles, toggling activation status,
      and hard-deleting accounts. Operators have no access to this resource.
    name: Users
  - description: >-
      The AdUnit Management API provides comprehensive functionalities for
      managing ad units and related resources. AdUnits are organized in a
      hierarchical path structure derived from their code and parent path. Only
      admin and operator roles have access — advertisers cannot access raw
      inventory. References:
      [Placement](https://docs.aiderx.io/guides/about-a2/en/placement)
    name: AdUnit
  - description: >-
      Ad catalog management. CRUD for ad catalogs plus public shared-view access
      via a share link.
    name: Ad Catalogs
  - description: >-
      Ad source (demand partner) management. CRUD for external ad sources that
      supply demand to ad units.
    name: AdSource
  - description: >-
      Allocation management. An allocation binds a line item to a serving target
      such as an ad unit. Covers CRUD, status counts, and single-allocation
      lookup.
    name: Allocations
  - description: >-
      Associated items pool (admin). Bulk upsert/delete and lookup of
      associated-items pools used by the recommendation pipeline.
    name: AssociatedItemsPool
  - description: >-
      Custom targeting segment management. CRUD and bulk operations for custom
      targeting segments.
    name: Custom Targeting Segment
  - description: Audit log access. Read the system audit log of administrative actions.
    name: Audit Logs
  - description: >-
      Creative block list. List, block, and unblock creatives to exclude them
      from serving.
    name: Blocked Creative
  - description: Catalog item management. List and update catalog (product/data) items.
    name: Catalogs
  - description: >-
      Creative asset management. Operators and admins manage creatives;
      advertisers see only their own. Deletion is blocked while any line-item
      association (LICA) still exists.
    name: Creatives
  - description: >-
      Dashboard aggregates. Summary data, inventory, and line-item metric
      rollups for the console dashboard.
    name: Dashboard
  - description: Experiment management. CRUD for A/B and optimization experiments.
    name: Experiment
  - description: >-
      External creative inspection. Read-only access to creatives ingested from
      external demand sources.
    name: External Creative
  - description: >-
      Third-party integration management. Manage integration sources (external
      data/serving connectors), probe connectivity, and read public
      (sensitive-config-redacted) configs.
    name: Integration
  - description: >-
      Line Item–Creative Associations (LICA). Associates creatives with line
      items, including batch create and delete (max 100, partial failure
      allowed) and dashboard counts.
    name: LICAs
  - description: License information. Read available license features and usage metrics.
    name: License
  - description: >-
      Line item management within an order. Covers create, update, delete, batch
      operations (max 100, partial failure allowed), and status transitions. A
      line item defines budget, goal, schedule, and targeting under its parent
      order.
    name: LineItems
  - description: Media library. List, upload, and delete media files used by creatives.
    name: Media Library
  - description: >-
      Metric query endpoints. Retrieve aggregated metrics for ad units,
      creatives, line items, and related entities.
    name: Metric
  - description: >-
      Advertiser order management. Operators and admins create and manage orders
      that group line items under a single budget; advertisers can read their
      own. Includes batch operations (max 100) and draft-only deletion rules.
    name: Orders
  - description: >-
      Placement management. A placement maps ad units to a serving surface.
      Endpoints cover CRUD and replacing the ad units bound to a placement.
    name: Placements
  - description: >-
      System settings. Read and update system configuration, including site
      logo, public URL, TLS, and access-token regeneration.
    name: Settings
  - description: System resources. Public static resources such as the site logo.
    name: System
  - description: >-
      Operational/developer control endpoints. Low-level ext patches and health
      checks intended for internal operation, not general API consumers.
    name: developer
  - description: >-
      Operational allocation control. Update allocation ext or force-update
      status (admin only).
    name: developer/control/allocations
  - description: >-
      Ad-serving monitoring (operational). Read ad-serving status, ad-unit
      monitoring history, and alerts.
    name: developer/monitoring
  - description: Internal health and probe endpoints.
    name: internal
  - description: >-
      Manager-level utility endpoints (e.g. service health) not tied to a
      specific resource.
    name: manager
  - description: Manage mappings between ad units, native formats, and native styles.
    name: Ad Unit Native Style
  - description: Manage custom targeting keys, including lifecycle and bulk operations.
    name: Custom Targeting Key
  - description: >-
      Manage values belonging to custom targeting keys, including lifecycle and
      bulk operations.
    name: Custom Targeting Value
  - description: Manage native formats and the fields that define each format.
    name: Native Format
  - description: List templates available for native styles.
    name: Native Style Template
  - description: Manage native rendering styles.
    name: Native Style
paths:
  /api/manager/ad-units/targets/{ad_unit_id}:
    get:
      tags:
        - AdUnit
      summary: Get Ad Unit Target Detail
      description: >-
        Returns advertiser-safe ad unit detail for allocation target selection
        (name, description, active status, sizes, enabled ad types, video format
        — for native format/style mappings use GET
        /ad-unit-native-styles?ad_unit_id=).
      operationId: >-
        handle_get_ad_unit_target_detail_api_manager_ad_units_targets__ad_unit_id__get
      parameters:
        - in: path
          name: ad_unit_id
          required: true
          schema:
            format: uuid
            title: Ad Unit Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdUnitTargetDetailResponse'
          description: Successful Response
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: Resource not found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    AdUnitTargetDetailResponse:
      description: |-
        GET /ad-units/targets/{id} — 광고주 공개용 AdUnit 상세.

        생성자·정산 정보(created_by, ext.payout 등)는 제외한다.
        native 포맷/스타일 정보는 여기 포함하지 않는다 — advertiser는 기존
        GET /ad-unit-native-styles?ad_unit_id= 를 별도로 호출해서 가져온다
        (운영자 상세 페이지도 동일 패턴: FE에서 두 API를 따로 호출해 조합).
      properties:
        ad_types:
          description: Enabled creative types.
          items:
            $ref: '#/components/schemas/AdUnitType'
          title: Ad Types
          type: array
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        id:
          format: uuid
          title: Id
          type: string
        is_active:
          title: Is Active
          type: boolean
        name:
          title: Name
          type: string
        path:
          title: Path
          type: string
        sizes:
          items:
            $ref: '#/components/schemas/AdUnitSize'
          title: Sizes
          type: array
        video:
          anyOf:
            - $ref: '#/components/schemas/VideoPlacement'
            - type: 'null'
          description: Video placement configuration (video가 활성화된 경우만).
      required:
        - id
        - name
        - path
        - description
        - is_active
        - sizes
        - ad_types
      title: AdUnitTargetDetailResponse
      type: object
    HTTPExceptionResponse:
      properties:
        detail:
          description: Detailed explanation for the exception
          title: Detail
          type: string
      required:
        - detail
      title: HTTPExceptionResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    AdUnitType:
      enum:
        - display
        - video
        - native
      title: AdUnitType
      type: string
    AdUnitSize:
      properties:
        h:
          description: Height in pixels.
          minimum: 0
          title: H
          type: integer
        w:
          description: Width in pixels.
          minimum: 0
          title: W
          type: integer
      required:
        - h
        - w
      title: AdUnitSize
      type: object
    VideoPlacement:
      properties:
        api:
          anyOf:
            - items:
                maximum: 65535
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Api
        boxing:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          default: 1
          title: Boxing
        clktype:
          $ref: '#/components/schemas/Click'
          default: 1
          description: >-
            Click type. 0: none, 1: unknown, 2: embedded browser, 3: native
            browser.
        comp:
          anyOf:
            - items:
                $ref: '#/components/schemas/Companion'
              type: array
            - type: 'null'
          title: Comp
        comptype:
          anyOf:
            - items:
                $ref: '#/components/schemas/CompanionType'
              type: array
            - type: 'null'
          title: Comptype
        ctype:
          description: List of creative types.
          items:
            type: integer
          title: Ctype
          type: array
        delay:
          default: 0
          description: Ad start delay (seconds).
          title: Delay
          type: integer
        delivery:
          anyOf:
            - items:
                $ref: '#/components/schemas/DeliveryMethod'
              type: array
            - type: 'null'
          title: Delivery
        expdir:
          anyOf:
            - items:
                $ref: '#/components/schemas/ExpandableDirection'
              type: array
            - type: 'null'
          title: Expdir
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          default: 300
          description: Video height (px).
          title: H
          type: integer
        linear:
          default: 0
          description: 'Linearity. 0: unknown, 1: linear, 2: non-linear.'
          title: Linear
          type: integer
        maxbitr:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Maxbitr
        maxdur:
          default: 0
          description: Maximum allowed duration (seconds).
          title: Maxdur
          type: integer
        maxext:
          anyOf:
            - type: integer
            - type: 'null'
          default: 0
          title: Maxext
        maxseq:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Maxseq
        mime:
          description: List of supported MIME types.
          items:
            type: string
          title: Mime
          type: array
        minbitr:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Minbitr
        mincpmpersec:
          anyOf:
            - type: number
            - type: 'null'
          title: Mincpmpersec
        mindur:
          default: 0
          description: Minimum allowed duration (seconds).
          title: Mindur
          type: integer
        overlayexpdir:
          anyOf:
            - items:
                $ref: '#/components/schemas/ExpandableDirection'
              type: array
            - type: 'null'
          title: Overlayexpdir
        playend:
          anyOf:
            - $ref: '#/components/schemas/PlaybackCessationMode'
            - type: 'null'
        playmethod:
          description: List of playback methods.
          items:
            $ref: '#/components/schemas/PlaybackMethod'
          title: Playmethod
          type: array
        poddur:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Poddur
        podid:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Podid
        podseq:
          anyOf:
            - $ref: '#/components/schemas/PodSequence'
            - type: 'null'
          default: 0
          description: 'Pod sequence. -1: last, 0: any, 1: first.'
        pos:
          anyOf:
            - $ref: '#/components/schemas/PlacementPosition'
            - type: 'null'
        ptype:
          $ref: '#/components/schemas/PlacementSubtypeVideo'
          default: 1
          description: >-
            Video placement type. 1: in-stream, 2: in-banner, 3: in-article, 4:
            in-feed, 5: interstitial.
        rqddurs:
          anyOf:
            - items:
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Rqddurs
        skip:
          default: 0
          description: 'Skippable flag. 0: not skippable, 1: skippable.'
          title: Skip
          type: integer
        skipafter:
          default: 0
          description: Playback position at which skip button appears (seconds).
          title: Skipafter
          type: integer
        skipmin:
          default: 0
          description: Minimum ad duration before skip button appears (seconds).
          title: Skipmin
          type: integer
        slotinpod:
          anyOf:
            - $ref: '#/components/schemas/SlotPositionInPod'
            - type: 'null'
          default: 0
          description: 'Slot position in pod. -1: last, 0: any, 1: first, 2: first or last.'
        unit:
          anyOf:
            - $ref: '#/components/schemas/Size'
            - type: 'null'
          default: 2
          description: 'Size unit. 1: DIPS, 2: inches, 3: centimeters.'
        w:
          default: 480
          description: Video width (px).
          title: W
          type: integer
      title: VideoPlacement
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    Click:
      enum:
        - 0
        - 1
        - 2
        - 3
      title: Click
      type: integer
    Companion:
      properties:
        display:
          anyOf:
            - $ref: >-
                #/components/schemas/a2_adm__generated__ad_unit__DisplayPlacement
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        vcm:
          anyOf:
            - type: integer
            - type: 'null'
          title: Vcm
      title: Companion
      type: object
    CompanionType:
      enum:
        - Static
        - HTML
        - IFrame
      title: CompanionType
      type: string
    DeliveryMethod:
      enum:
        - Streaming
        - Progressive
        - Download
      title: DeliveryMethod
      type: string
    ExpandableDirection:
      enum:
        - Left
        - Right
        - Up
        - Down
        - FullScreen
        - ResizeMinimize
      title: ExpandableDirection
      type: string
    PlaybackCessationMode:
      enum:
        - OnVideoCompletion
        - OnLeavingViewport
        - OnLeavingViewportContinuesAsAUnit
      title: PlaybackCessationMode
      type: string
    PlaybackMethod:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
      title: PlaybackMethod
      type: integer
    PodSequence:
      enum:
        - -1
        - 0
        - 1
      title: PodSequence
      type: integer
    PlacementPosition:
      enum:
        - Unknown
        - AboveTheFold
        - Locked
        - BelowTheFold
        - Header
        - Footer
        - Sidebar
        - FullScreen
      title: PlacementPosition
      type: string
    PlacementSubtypeVideo:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      title: PlacementSubtypeVideo
      type: integer
    SlotPositionInPod:
      enum:
        - -1
        - 0
        - 1
        - 2
      title: SlotPositionInPod
      type: integer
    Size:
      enum:
        - 1
        - 2
        - 3
      title: Size
      type: integer
    a2_adm__generated__ad_unit__DisplayPlacement:
      properties:
        ampren:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          title: Ampren
        api:
          anyOf:
            - items:
                maximum: 65535
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Api
        clktype:
          default: 1
          maximum: 255
          minimum: 0
          title: Clktype
          type: integer
        context:
          anyOf:
            - $ref: '#/components/schemas/DisplayContext'
            - type: 'null'
        ctype:
          anyOf:
            - items:
                maximum: 255
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Ctype
        displayfmt:
          anyOf:
            - $ref: '#/components/schemas/DisplayFormat'
            - type: 'null'
        event:
          anyOf:
            - items:
                $ref: '#/components/schemas/EventSpec'
              type: array
            - type: 'null'
          title: Event
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          anyOf:
            - type: number
            - type: 'null'
          title: H
        ifrbust:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Ifrbust
        mime:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Mime
        pos:
          anyOf:
            - $ref: '#/components/schemas/PlacementPosition'
            - type: 'null'
        priv:
          default: 0
          maximum: 255
          minimum: 0
          title: Priv
          type: integer
        ptype:
          anyOf:
            - $ref: '#/components/schemas/DisplayPlacementTypes'
            - type: 'null'
        topframe:
          anyOf:
            - maximum: 255
              minimum: 0
              type: integer
            - type: 'null'
          title: Topframe
        unit:
          default: 2
          maximum: 255
          minimum: 0
          title: Unit
          type: integer
        w:
          anyOf:
            - type: number
            - type: 'null'
          title: W
      title: DisplayPlacement
      type: object
    DisplayContext:
      enum:
        - ContentCentric
        - ArticleContent
        - VideoContent
        - AudioContent
        - ImageContent
        - UserGeneratedContent
        - SocialCentric
        - EmailContent
        - ChatContent
        - ProductContext
        - AppStore
        - ProductReviews
      title: DisplayContext
      type: string
    DisplayFormat:
      properties:
        expdir:
          anyOf:
            - $ref: '#/components/schemas/ExpandableDirection'
            - type: 'null'
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        h:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: H
        hratio:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Hratio
        w:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: W
        wratio:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          title: Wratio
      title: DisplayFormat
      type: object
    EventSpec:
      properties:
        api:
          anyOf:
            - items:
                maximum: 65535
                minimum: 0
                type: integer
              type: array
            - type: 'null'
          title: Api
        ext:
          anyOf:
            - {}
            - type: 'null'
          title: Ext
        jstrk:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Jstrk
        method:
          anyOf:
            - items:
                $ref: '#/components/schemas/EventTrackingMethod'
              type: array
            - type: 'null'
          title: Method
        pxtrk:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Pxtrk
        type:
          $ref: '#/components/schemas/EventType'
        wjs:
          default: 1
          title: Wjs
          type: integer
        wpx:
          default: 1
          title: Wpx
          type: integer
      required:
        - type
      title: EventSpec
      type: object
    DisplayPlacementTypes:
      enum:
        - Feed
        - AtomicUnit
        - OutsideCore
        - RecommendationWidget
      title: DisplayPlacementTypes
      type: string
    EventTrackingMethod:
      enum:
        - 1
        - 2
      title: EventTrackingMethod
      type: integer
    EventType:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      title: EventType
      type: integer
  securitySchemes:
    HTTPBearer:
      description: >-
        Bearer authentication. Pass the access token in the `Authorization:
        Bearer <token>` header.
      scheme: bearer
      type: http

````