---
title: "GET /v1/bidders/{biddersId}/auctionPackages"
method: GET
path: "/v1/bidders/{biddersId}/auctionPackages"
tags: ["bidders"]
---

# GET /v1/bidders/{biddersId}/auctionPackages

`GET /v1/bidders/{biddersId}/auctionPackages`

## Request

- Base URL: `https://authorizedbuyersmarketplace.googleapis.com`
- URL: `https://authorizedbuyersmarketplace.googleapis.com/v1/bidders/{biddersId}/auctionPackages`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/authorized-buyers-marketplace`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/authorized-buyers-marketplace`

List the auction packages. Buyers can use the URL path "/v1/buyers/{accountId}/auctionPackages" to list auction packages for the current buyer and its clients. Bidders can use the URL path "/v1/bidders/{accountId}/auctionPackages" to list auction packages for the bidder, its media planners, its buyers, and all their clients.

## Path parameters

- `biddersId` string, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListAuctionPackagesResponse: Response message for listing auction packages.
  - `auctionPackages` AuctionPackage[]: The list of auction packages.
    - `createTime` string, google-datetime: Output only. Time the auction package was created.
    - `creator` string: Output only. The buyer that created this auction package. Format: `buyers/{buyerAccountId}`
    - `dealOwnerSeatId` string: Output only. If set, this field contains the DSP specific seat id set by the media planner account that is considered the owner of this deal. The seat ID is in the calling DSP's namespace.
    - `description` string: Output only. A description of the auction package.
    - `displayName` string: The display_name assigned to the auction package.
    - `eligibleSeatIds` string[]: Output only. If set, this field identifies a seat that the media planner selected as the owner of this auction package. This is a seat ID in the DSP's namespace that was provided to the media planner.
    - `floorPriceCpm` Money: Represents an amount of money with its currency type.
      - `currencyCode` string: The three-letter currency code defined in ISO 4217.
      - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
      - `units` string, int64: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `name` string: Immutable. The unique identifier for the auction package. Format: `buyers/{accountId}/auctionPackages/{auctionPackageId}` The auction_package_id part of name is sent in the BidRequest to all RTB bidders and is returned as deal_id by the bidder in the BidResponse.
    - `subscribedBuyers` string[]: Output only. The list of buyers that are subscribed to the AuctionPackage. This field is only populated when calling as a bidder. Format: `buyers/{buyerAccountId}`
    - `subscribedClients` string[]: Output only. When calling as a buyer, the list of clients of the current buyer that are subscribed to the AuctionPackage. When calling as a bidder, the list of clients that are subscribed to the AuctionPackage owned by the bidder or its buyers. Format: `buyers/{buyerAccountId}/clients/{clientAccountId}`
    - `subscribedMediaPlanners` MediaPlanner[]: Output only. The list of media planners that are subscribed to the AuctionPackage. This field is only populated when calling as a bidder.
      - `accountId` string: Output only. Account ID of the media planner.
      - `ancestorNames` string[]: Output only. The ancestor names of the media planner. Format: `mediaPlanners/{mediaPlannerAccountId}` Can be used to filter the response of the mediaPlanners.list method.
      - `displayName` string: Output only. The display name of the media planner. Can be used to filter the response of the mediaPlanners.list method.
      - `name` string: Identifier. The unique resource name of the media planner. Format: `mediaPlanners/{mediaPlannerAccountId}` Can be used to filter the response of the mediaPlanners.list method.
    - `updateTime` string, google-datetime: Output only. Time the auction package was last updated. This value is only increased when this auction package is updated but never when a buyer subscribed.
  - `nextPageToken` string: Continuation token for fetching the next page of results. Pass this value in the ListAuctionPackagesRequest.pageToken field in the subsequent call to the `ListAuctionPackages` method to retrieve the next page of results.

## Changes

- **2026-10-29** `4e374f878f32`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/changes/v1/bidders/:biddersId/auctionPackages/get.md)

---

[API](https://skmtc.dev/google/apis/authorizedbuyersmarketplace.md) - [All operations](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/revisions/4e374f878f32?raw)