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

# List All Partners

`GET /Advertisers/{AccountSID}/MediaPartners`

## Request

- Base URL: `https://api.impact.com`
- URL: `https://api.impact.com/Advertisers/{AccountSID}/MediaPartners`
- Auth: none declared
- TypeScript: <https://skmtc.dev/impact/apis/brand-api-account-information/docs/Advertisers/:AccountSID/MediaPartners/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/impact/apis/brand-api-account-information.md) - [All operations](https://skmtc.dev/impact/apis/brand-api-account-information/llms.txt) - [OpenAPI document](https://skmtc.dev/impact/apis/brand-api-account-information/revisions/c53422ebb833?raw)