# Models

## The Partner object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Partners","version":"v14"},"components":{"schemas":{"Partner":{"type":"object","properties":{"Id":{"type":"string","description":"The unique identifier for the partner."},"Name":{"type":"string","description":"The display name of the partner."},"Description":{"type":"string","description":"A description of the partner."},"Website":{"type":"string","format":"uri","description":"The partner's website URL."},"State":{"type":"string","description":"The current state of the partner's account.","enum":["ACTIVE","EXPIRED","PENDING","DECLINED","SUSPENDED","DEACTIVATED","CLOSING","CLOSED","NOT_APPLICABLE"]},"Address":{"type":"object","description":"The partner's address.","properties":{"Country":{"type":"string","description":"Two-letter ISO 3166-1 alpha-2 country code."},"Address1":{"type":"string","description":"Address line 1."},"Address2":{"type":"string","nullable":true,"description":"Address line 2."},"City":{"type":"string","description":"City, district, suburb, town, or village."},"State":{"type":"string","description":"State or region."},"PostalCode":{"type":"string","description":"ZIP or postal code."}}},"Phone":{"type":"object","description":"The partner's contact phone number.","properties":{"Country":{"type":"string","description":"Two-letter ISO 3166-1 alpha-2 country code for the phone number."},"Number":{"type":"string","description":"The phone number."}}},"Currency":{"type":"string","description":"Three-letter ISO 4217 currency code for the partner's payouts."},"Timezone":{"type":"string","description":"The partner's timezone."},"IndirectTax":{"type":"object","description":"The partner's indirect tax registration details.","properties":{"Country":{"type":"string","description":"Country code for the tax registration."},"Number":{"type":"string","description":"Indirect tax registration number (e.g., VAT, GST)."}}},"PartnerType":{"type":"string","description":"Whether the partner is a direct or marketplace partner.","enum":["DIRECT","MARKETPLACE"]},"PromotionalMethods":{"type":"array","description":"The partner's promotional methods.","items":{"type":"object","properties":{"Type":{"type":"string","description":"The type of promotional method (e.g., EMAIL, SEARCH, CONTENT)."},"IsPrimary":{"type":"boolean","description":"Whether this is the partner's primary promotional method."}}}},"PromotionalCountries":{"type":"array","description":"Country codes where the partner promotes.","items":{"type":"string"}},"Properties":{"type":"array","description":"The partner's promotional properties (websites, apps, social accounts).","items":{"type":"object","properties":{"Id":{"type":"string","description":"The unique identifier for the promotional property."},"Name":{"type":"string","description":"Display name of the promotional property."},"Type":{"type":"string","description":"The category of promotional property.","enum":["WEBSITE","MOBILE","SOCIAL"]},"Platform":{"type":"string","description":"The specific platform (e.g., FACEBOOK, TWITTER)."},"Url":{"type":"string","format":"uri","description":"URL of the promotional property."}}}},"PromotionalCategories":{"type":"array","description":"Categories the partner promotes in.","items":{"type":"string"}},"Programs":{"type":"array","description":"The programs the partner is joined to.","items":{"type":"object","properties":{"Id":{"type":"string","description":"The unique identifier of the program."},"Name":{"type":"string","description":"The display name of the program."},"ContractId":{"type":"string","description":"The unique identifier of the partner's contract on this program."},"ContractName":{"type":"string","description":"The display name of the contract."},"JoinDate":{"type":"string","format":"date-time","description":"The date and time the partner joined the program."},"ExpirationDate":{"type":"string","format":"date-time","nullable":true,"description":"The date and time the partner's contract expires."}}}},"Contacts":{"type":"array","description":"Contacts at the partner organization.","items":{"type":"object","properties":{"FirstName":{"type":"string","description":"The contact's first name."},"LastName":{"type":"string","description":"The contact's last name."},"Email":{"type":"string","format":"email","description":"The contact's email address."},"IsPrimary":{"type":"boolean","description":"Whether this is the partner's primary contact."}}}},"LinkedAccounts":{"type":"array","description":"Other accounts linked to this partner.","items":{"type":"object","properties":{"Id":{"type":"string","description":"The unique identifier of the linked account."},"Reason":{"type":"string","description":"The reason the accounts are linked."},"Date":{"type":"string","format":"date-time","description":"The date and time the accounts were linked."}}}},"PartnerValues":{"type":"object","description":"Custom tracking values associated with the partner.","properties":{"Value1":{"type":"string","description":"Custom tracking value 1."},"Value2":{"type":"string","description":"Custom tracking value 2."},"Value3":{"type":"string","description":"Custom tracking value 3."}}},"AccountManager":{"type":"string","description":"The account manager assigned to this partner."},"DateCreated":{"type":"string","format":"date-time","description":"The date and time the partner account was created."},"DateLastUpdated":{"type":"string","format":"date-time","description":"The date and time the partner account was last updated."},"CreatedBy":{"type":"string","description":"The user who created the partner account."},"LastUpdatedBy":{"type":"string","description":"The user who last updated the partner account."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to this partner in the impact.com API."}}}}}}
```

## The PartnerCreate object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Partners","version":"v14"},"components":{"schemas":{"PartnerCreate":{"type":"object","required":["AccountName","Website","AddressLine1","City","PostalCode","Country","PhoneCountry","PhoneNumber","PrimaryPromotionalMethod","Username","FirstName","LastName","Password","EmailAddress","TemplateTermsId","Currency"],"properties":{"AccountName":{"type":"string","description":"The display name for the partner's account."},"Website":{"type":"string","format":"uri","description":"The partner's website URL."},"AddressLine1":{"type":"string","description":"Address line 1."},"City":{"type":"string","description":"City for the partner's address."},"PostalCode":{"type":"string","description":"ZIP or postal code."},"Country":{"type":"string","description":"Two-letter ISO 3166-1 alpha-2 country code. Possible values: `US`, `UK`, `CANADA`, `AUSTRALIA`, `GERMANY`, `FRANCE`, `AFGHANISTAN`, `ALAND ISLANDS`, `ALBANIA`, `ALGERIA`, `AMERICANSAMOA`, `ANDORRA`, `ANGOLA`, `ANGUILLA`, `ANTARCTICA`, `ANTIGUABARBUDA`, `ARGENTINA`, `ARMENIA`, `ARUBA`, `AUSTRIA`, `AZERBAIJAN`, `BAHAMAS`, `BAHRAIN`, `BANGLADESH`, `BARBADOS`, `BELARUS`, `BELGIUM`, `BELIZE`, `BENIN`, `BERMUDA`, `BHUTAN`, `BOLIVIA`, `BOSNIAHERZEGOVINA`, `BOTSWANA`, `BRAZIL`, `BRITISHINDIANOCEANTERRITORY`, `BRUNEIDARUSSALAM`, `BULGARIA`, `BURKINAFASO`, `BURUNDI`, `CAMBODIA`, `CAMEROON`, `CAPVERDE`, `CAYMANISLANDS`, `CENTRALAFRICANREPUBLIC`, `CHAD`, `CHILE`, `CHINA`, `CHRISTMASISLAND`, `COCOSISLANDS`, `COLOMBIA`, `COMOROS`, `CONGO`, `DEMOCRATICREPUBLICCONGO`, `COOKISLANDS`, `COSTARICA`, `IVORYCOAST`, `CROATIA`, `CUBA`, `CYPRUS`, `CZECHREPUBLIC`, `DENMARK`, `DIJIBOUTI`, `DOMINICA`, `DOMINICANREPUBLIC`, `ECUADOR`, `EGYPT`, `ELSALVADOR`, `EQUATORIALGUINEA`, `ERITREA`, `ESTONIA`, `ETHIOPIA`, `FALKLANDISLANDS`, `FAROEISLANDS`, `FIJI`, `FINLAND`, `FRENCHGUIANA`, `FRENCHPOLYNESIA`, `FRENCHSOUTHERNTERRITORIES`, `GABON`, `GAMBIA`, `GEORGIA`, `GHANA`, `GIBRALTAR`, `GREECE`, `GREENLAND`, `GRENADA`, `GUADELOUPE`, `GUAM`, `GUATEMALA`, `GUERNSEY`, `GUINEA`, `GUINEABISSAU`, `GUYANA`, `HAITI`, `VATICAN`, `HONDURAS`, `HONGKONG`, `HUNGARY`, `ICELAND`, `INDIA`, `INDONESIA`, `IRAN`, `IRAQ`, `IRELAND`, `ISLE OF MAN`, `ISRAEL`, `ITALY`, `JAMAICA`, `JAPAN`, `JERSEY`, `JORDAN`, `KAZAKHSTAN`, `KENYA`, `KIRIBATI`, `SOUTHKOREA`, `KUWAIT`, `KYRGYZSTAN`, `LAOS`, `LATVIA`, `LEBANON`, `LESOTHO`, `LIBERIA`, `LIBYA`, `LICHTENSTEIN`, `LITHUANIA`, `LUXEMBOURG`, `MACAO`, `MACEDONIA`, `MADAGASCAR`, `MALAWI`, `MALAYSIA`, `MALDIVES`, `MALI`, `MALTA`, `MARSHALLISLANDS`, `MARTINIQUE`, `MAURITANIA`, `MAURITIUS`, `MAYOTTE`, `MEXICO`, `MICRONESIA`, `MOLDOVA`, `MONACO`, `MONGOLIA`, `MONTENEGRO`, `MONTSERRAT`, `MOROCCO`, `MOZAMBIQUE`, `MYANMAR`, `NAMIBIA`, `NAURU`, `NEPAL`, `NETHERLANDS`, `NETHERLANDSANTILLES`, `NEWCALEDONIA`, `NEWZEALAND`, `NICARAGUA`, `NIGER`, `NIGERIA`, `NIUE`, `NORFOLKISLAND`, `NORTHKOREA`, `NORTHERNMARIANAISLANDS`, `NORWAY`, `OMAN`, `PAKISTAN`, `PALAU`, `PALESTINIANTERRITORY`, `PANAMA`, `PAPUANEWGUINEA`, `PARAGUAY`, `PERU`, `PHILIPPINES`, `PITCAIRN`, `POLAND`, `PORTUGAL`, `PUERTORICO`, `QATAR`, `REUNION`, `ROMANIA`, `RUSSIA`, `RWANDA`, `SAINTHELENA`, `SAINTKITTSNEVIS`, `SAINTLUCIA`, `SAINTPIERREMIQUELON`, `SAINTVINCENTGRENADINES`, `SAMOA`, `SANMARINO`, `SAOTOME`, `SAUDIARABIA`, `SENEGAL`, `SERBIA`, `YUGOSLAVIA`, `SEYCHELLES`, `SIERRALEONE`, `SINGAPORE`, `SLOVAKIA`, `SLOVENIA`, `SOLOMONISLANDS`, `SOMALIA`, `SOUTHAFRICA`, `SPAIN`, `SRILANKA`, `SUDAN`, `SURINAME`, `SVALBARDJANMAYEN`, `SWAZILAND`, `SWEDEN`, `SWITZERLAND`, `SYRIA`, `TAIWAN`, `TAJIKISTAN`, `TANZANIA`, `THAILAND`, `TIMOR`, `TOGO`, `TOKELAU`, `TONGA`, `TRINIDADTOBAGO`, `TUNISIA`, `TURKEY`, `TURKMENISTAN`, `TURKSCAICOSISLANDS`, `TUVALU`, `UGANDA`, `UKRAINE`, `UAE`, `UNITED STATES MINOR OUTLYING ISLANDS`, `URUGUAY`, `UZBEKISTAN`, `VANUATU`, `VENEZUELA`, `VIETNAM`, `BRITISHVIRGINISLANDS`, `USVIRGINISLANDS`, `WALLISFUTUNA`, `WESTERNSAHARA`, `YEMEN`, `ZAMBIA`, `ZIMBABWE`."},"PhoneCountry":{"type":"string","description":"Two-letter ISO 3166-1 alpha-2 country code for the phone number."},"PhoneNumber":{"type":"string","description":"The partner's contact phone number."},"PrimaryPromotionalMethod":{"type":"string","description":"The partner's primary method of promoting.","enum":["EMAIL","SEARCH","LOYALTY","COUPON","SYNDICATION_BLOG_NETWORKS","CPA_NETWORK","MOBILE","CONTENT","SHOPPING","SOCIAL_MEDIA_INFLUENCER","SERVICE_PROVIDER","CONSUMER_SOFTWARE","INCENTIVIZED","OFFLINE","OTHER","CASHBACK"]},"Username":{"type":"string","description":"The username for the partner's primary user account."},"FirstName":{"type":"string","description":"First name of the primary contact."},"LastName":{"type":"string","description":"Last name of the primary contact."},"Password":{"type":"string","format":"password","description":"Password for the primary user account."},"EmailAddress":{"type":"string","format":"email","description":"Email address of the primary contact."},"TemplateTermsId":{"type":"integer","description":"The unique ID of the contract template to assign to this partner."},"Currency":{"type":"string","description":"3-letter ISO 4217 currency code."},"TaxId":{"type":"string","description":"Tax identification number for the partner."},"OrganizationType":{"type":"string","description":"Organization type for the partner.","enum":["NONP_GOV","CORP","SOLE_IND","LLC_LLP_LLS","TRUST","SOLE_TRD","PARTNERS","LLC","LLP","COMPANY","GOVERNMENT","OTHER"]},"AddressLine2":{"type":"string","description":"Address line 2."},"CountryState":{"type":"string","description":"State or region within the country."},"Timezone":{"type":"string","description":"The partner's timezone."},"PromotingCountries":{"type":"string","description":"Comma-separated list of 2-letter ISO 3166-1 alpha 2 country codes."},"Description":{"type":"string","description":"A description of the partner."},"MPGroupIDs":{"type":"string","description":"Comma-separated list of partner group IDs to add the partner to."},"MPValue1":{"type":"string","description":"Custom tracking value 1."},"MPValue2":{"type":"string","description":"Custom tracking value 2."},"MPValue3":{"type":"string","description":"Custom tracking value 3."}}}}}}
```

## The SuccessUriResponse object

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Partners","version":"v14"},"components":{"schemas":{"SuccessUriResponse":{"type":"object","properties":{"Status":{"type":"string","description":"Indicates whether the operation was successful."},"Uri":{"type":"string","format":"uri-reference","description":"The unique reference to the affected partner."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/reference/partners/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.