---
title: "List All Partners"
method: GET
path: "/Advertisers/{AccountSID}/MediaPartners"
tags: ["Partners"]
---

# List All Partners

`GET /Advertisers/{AccountSID}/MediaPartners`

Returns a list of all partner accounts in your program, with extensive filtering options.

## Path parameters

- `AccountSID` string, required

## Query parameters

- `Id` string
- `CampaignId` integer
- `GroupId` integer
- `Country` string
- `startDate` string, date-time
- `endDate` string, date-time
- `State` string
- `RelationshipState` string

## Response `200`

A paginated list of partner objects.

- object
  - `Partners` Partner[] — The list of partner objects.
    - `Id` string — The unique identifier for the partner.
    - `Name` string — The display name of the partner.
    - `Description` string — A description of the partner.
    - `Website` string, uri — The partner's website URL.
    - `State` string — The current state of the partner's account.
    - `Address` Address
      - `AddressLine1` string — Address line 1 (address number, street name)
      - `AddressLine2` string — Address line 2 (building, unit, suite, etc. number)
      - `City` string — City, district, suburb, town, or village
      - `State` string — State or territory
      - `PostalCode` string — ZIP or postal code
      - `Country` string — Two-letter country code. See ISO 3166-1 alpha-2.
    - `Phone` Phone
      - `Country` string — Two-letter ISO 3166-1 alpha-2 country code for the phone number.
      - `Number` string — The phone number.
    - `Currency` string — Three-letter ISO 4217 currency code for the partner's payouts.
    - `Timezone` string — The partner's timezone.
    - `IndirectTax` IndirectTax
      - `Country` string — Country code for the tax registration.
      - `Number` string — Indirect tax registration number (e.g., VAT, GST).
    - `PartnerType` 'DIRECT' | 'MARKETPLACE' — Whether the partner is a direct or marketplace partner.
    - `PromotionalMethods` PromotionalMethod[] — The partner's promotional methods.
      - `Type` string — The type of promotional method (e.g., EMAIL, SEARCH, CONTENT).
      - `IsPrimary` boolean — Whether this is the partner's primary promotional method.
    - `PromotionalCountries` string[] — Country codes where the partner promotes.
    - `Properties` PromotionalProperty[] — The partner's promotional properties (websites, apps, social accounts).
      - `Id` string — The unique identifier for the promotional property.
      - `Name` string — Display name of the promotional property.
      - `Type` 'WEBSITE' | 'MOBILE' | 'SOCIAL' — The category of promotional property.
      - `Platform` string — The specific platform (e.g., FACEBOOK, TWITTER).
      - `Url` string, uri — URL of the promotional property.
      - `Doe` string, date-time — The date and time the property was created (date of entry).
      - `Dlu` string, date-time — The date and time the property was last updated.
    - `PromotionalCategories` string[] — Categories the partner promotes in.
    - `Programs` PartnerProgram[] — The programs the partner is joined to.
      - `Id` string — The unique identifier of the program.
      - `Name` string — The display name of the program.
      - `ContractId` string — The unique identifier of the partner's contract on this program.
      - `ContractName` string — The display name of the contract.
      - `JoinDate` string, date-time — The date and time the partner joined the program.
      - `ExpirationDate` string, date-time, nullable — The date and time the partner's contract expires.
      - `Groups` object[] — Partner groups the partner is a member of within this program.
        - `GroupId` string — The unique identifier of the partner group.
        - `GroupName` string — The display name of the partner group.
    - `Contacts` PartnerContact[] — Contacts at the partner organization.
      - `FirstName` string — The contact's first name.
      - `LastName` string — The contact's last name.
      - `Labels` string[] — Labels tagged on the contact.
      - `Email` string, email — The contact's email address.
      - `Phones` object[] — The contact's phone numbers.
        - `Type` 'CELL' | 'WORK' — The type of phone number.
        - `Country` string — Two-letter ISO 3166-1 alpha-2 country code for the phone number.
        - `Number` string — The phone number.
      - `IsPrimary` boolean — Whether this is the partner's primary contact.
    - `LinkedAccounts` LinkedAccount[] — Other accounts linked to this partner.
      - `Id` string — The unique identifier of the linked account.
      - `Reason` string — The reason the accounts are linked.
      - `Date` string, date-time — The date and time the accounts were linked.
    - `PartnerValues` object — Custom tracking values associated with the partner.
      - `Value1` string — Custom tracking value 1.
      - `Value2` string — Custom tracking value 2.
      - `Value3` string — Custom tracking value 3.
    - `AccountManager` string — The account manager assigned to this partner.
    - `DateCreated` string, date-time — The date and time the partner account was created.
    - `DateLastUpdated` string, date-time — The date and time the partner account was last updated.
    - `CreatedBy` string — The user who created the partner account.
    - `LastUpdatedBy` string — The user who last updated the partner account.
    - `Uri` string, uri-reference — The unique reference to this partner in the impact.com API.

---

[API](https://skmtc.net/impact/apis/brand-api-account-information.md) · [All operations](https://skmtc.net/impact/apis/brand-api-account-information/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/impact/brand-api-account-information/revisions/c53422ebb833/schema)