Returns programme terms and conditions (T&C) for the advertisers named in advertiserId. Use it to check an advertiser's commission, paid search, partner-type and deduplication rules before or after joining their programme; a partnership is not required. The caller needs any role on the publisher account {publisherId}. Results are ordered numerically by advertiserId, ascending. Read-only; no side effects.
Personal Access Token, sent as Authorization: Bearer <token>.
Identifier of the publisher account.
Advertisers to return terms for; supply one id or several comma-separated, for example advertiserId=1001,1002. At most 50. Partnership is not required. An id that does not identify an existing advertiser, or identifies an advertiser with no stored terms, is omitted from results. Each id may appear only once.
Programme terms for the selected advertisers.
{
"results": [
{
"advertiserId": "1001",
"updatedAt": "2026-01-21T09:44:06Z",
"term": {
"commission": {
"transactionIncludeVat": false,
"transactionIncludeDeliveryCharges": true,
"transactionIncludeCreditCardsFees": false,
"transactionIncludeGiftWrapping": false,
"productCategoriesExcluded": true,
"productCategoriesExcludedList": [
"Category 1"
],
"declineCommissionReasons": [
"ORDER_CANCELED",
"ORDER_RETURNED"
]
},
"searchEnginePromo": {
"fullCommissionOnPaidSearch": true,
"fullCommissionOnDirectLinks": false,
"fullCommissionOnBrandNameUrl": false,
"fullCommissionOnBrandNamePaidSearch": false,
"fullCommissionOnBrandNameInNegativeKeywords": false,
"fullCommissionOnDisplayAdsWithBrandVariation": false,
"fullCommissionOnDisplayAdsWithMisspelling": false,
"fullCommissionOnDisplayAdsWithBrandAndOtherKeywords": false,
"fullCommissionOnPlaceShoppingAdsWithDirectLink": true,
"allowToEarnCommissionsOnSpecificGroups": false,
"commissionOnPaidSearchActivitySearchEngines": [
"YAHOO"
],
"commissionOnPaidSearchHasIneligibleKeywords": false,
"activityOnComparisonShoppingServiceInSeparateAccount": false
},
"preferredPartnerTypes": {
"allowedPartnerTypes": [
"MEDIA_BROKERS"
],
"promoTypesRestriction": false
},
"deduplication": {
"isDeduplicationOnAdvertiserChannels": true,
"deduplicationChannels": [
"PPC_BRAND"
]
},
"additionalTerms": "Additional programme terms (HTML).
",
"brandingTerms": "Branding terms (HTML).
"
}
},
{
"advertiserId": "1002",
"updatedAt": "2025-11-02T14:10:00Z",
"term": {
"commission": {
"transactionIncludeVat": true,
"transactionIncludeDeliveryCharges": false,
"transactionIncludeCreditCardsFees": false,
"transactionIncludeGiftWrapping": false,
"productCategoriesExcluded": false,
"declineCommissionReasons": [
"NOT_ELIGIBLE"
]
},
"searchEnginePromo": {
"fullCommissionOnPaidSearch": false,
"allowToEarnCommissionsOnSpecificGroups": false,
"commissionOnPaidSearchHasIneligibleKeywords": false,
"activityOnComparisonShoppingServiceInSeparateAccount": false
},
"preferredPartnerTypes": {
"allowedPartnerTypes": [],
"promoTypesRestriction": false
},
"deduplication": {
"isDeduplicationOnAdvertiserChannels": false,
"deduplicationChannels": []
},
"additionalTerms": "Short programme terms.
"
}
}
]
}Programme terms for the requested advertisers that exist and have stored terms, ordered numerically by advertiserId, ascending.
Programme terms for one requested advertiser.
Advertiser account identifier.
UTC timestamp when these programme terms were last updated.
Advertiser programme terms and conditions (T&C).
Commission calculation and decline rules.
Whether commission is calculated on the transaction amount including VAT.
Whether commission is calculated on the transaction amount including delivery charges.
Whether commission is calculated on the transaction amount including credit card fees.
Whether commission is calculated on the transaction amount including gift-wrapping charges.
Whether some product categories are excluded from commission. When true, productCategoriesExcludedList names those categories.
Product categories excluded from commission. Not empty when productCategoriesExcluded is true.
Reasons the advertiser may decline a commission. May be empty when no decline reasons are configured.
Free-text explanation used when declineCommissionReasons contains OTHER, in which case it is not blank.
Paid search and promotional activity rules.
Whether the publisher earns full commission on paid-search traffic.
Whether the publisher earns full commission on traffic from direct links. Omitted when fullCommissionOnPaidSearch is false.
Whether the publisher earns full commission when the brand name appears in the destination URL. Omitted when fullCommissionOnPaidSearch is false.
Whether the publisher earns full commission on paid search that bids on the brand name. Omitted when fullCommissionOnPaidSearch is false.
Whether the publisher still earns full commission when the brand name is present only as a negative keyword (the campaign excludes the brand rather than bidding on it). Omitted when fullCommissionOnPaidSearch is false.
Whether the publisher earns full commission on display ads that use a variation of the brand name. Omitted when fullCommissionOnPaidSearch is false.
Whether the publisher earns full commission on display ads that use a misspelling of the brand name. Omitted when fullCommissionOnPaidSearch is false.
Whether the publisher earns full commission on display ads that combine the brand name with other keywords. Omitted when fullCommissionOnPaidSearch is false.
Whether the publisher earns full commission on shopping ads that use a direct link to the advertiser. Omitted when fullCommissionOnPaidSearch is false.
Whether commission on paid search is limited to specific publisher groups. When true, allowToEarnCommissionsOnSpecificGroupsDetails describes those groups.
Which publisher groups may earn commission on paid search, as plain text. Present and not blank when allowToEarnCommissionsOnSpecificGroups is true; else omitted.
Search engines on which paid-search activity is allowed. At least one search engine is present when fullCommissionOnPaidSearch is true; omitted when it is false.
Notes for search engines other than the listed ones, as plain text. Present when commissionOnPaidSearchActivitySearchEngines contains OTHER.
Whether some keywords are ineligible for paid-search commission. When true, commissionOnPaidSearchIneligibleKeywords lists them.
Keywords that do not earn paid-search commission. Not empty, with no blank entries, when commissionOnPaidSearchHasIneligibleKeywords is true.
Whether comparison-shopping activity must run in an account separate from the publisher's other paid-search activity.
Allowed partner types and promo restrictions.
Publisher types the advertiser allows to promote the programme. Must contain at least one type.
Whether the advertiser restricts promotional methods beyond allowedPartnerTypes. When true, promoTypesRestrictionDetails describes the restriction.
Description of the promotional-method restriction. Present and not empty when promoTypesRestriction is true.
Deduplication settings across advertiser channels.
Whether the advertiser deduplicates publisher conversions against its own channels (for example paid search or email).
Advertiser channels that take priority over the publisher when deduplication is on, in which case it is not empty.
Additional programme terms written by the advertiser, as an HTML fragment. Omitted when the advertiser has not written any. Consumers must sanitise the HTML before rendering.
Branding terms written by the advertiser, as an HTML fragment. Omitted when the advertiser has not written any. Consumers must sanitise the HTML before rendering.
Invalid request: a non-numeric publisherId, or an invalid advertiserId query (missing, non-numeric, duplicated, or more than 50 ids).
{
"type": "https://help.awin.com/apis/error",
"title": "Bad Request",
"status": 400,
"detail": "The advertiserId query parameter is invalid.",
"code": "VALIDATION_FAILED",
"errors": [
{
"pointer": "/advertiserId",
"detail": "must contain between 1 and 50 numeric advertiser ids"
}
]
}A URI reference identifying the problem type. APIs SHOULD define a stable, dereferenceable URI per domain-specific problem type.
A short, human-readable summary of the problem type. Stable across occurrences; does not change from occurrence to occurrence.
The HTTP status code, repeated here for convenience.
A human-readable explanation specific to this occurrence. Intended for the developer, not the end user — do not parse it.
A URI reference identifying this specific occurrence, typically the request path.
A stable, machine-readable error code. It does not change when detail is reworded, so clients branch on code, never on detail.
One entry per field that failed validation.
A human-readable explanation of this field's failure.
Unauthorized
{
"type": "https://help.awin.com/apis/error",
"title": "Unauthorized",
"status": 401,
"detail": "No valid credentials were supplied with the request",
"code": "UNAUTHORIZED"
}Problem details for an HTTP API error, as defined by RFC 9457. Served as application/problem+json.
A URI reference identifying the problem type. APIs SHOULD define a stable, dereferenceable URI per domain-specific problem type.
A short, human-readable summary of the problem type. Stable across occurrences; does not change from occurrence to occurrence.
The HTTP status code, repeated here for convenience.
A human-readable explanation specific to this occurrence. Intended for the developer, not the end user — do not parse it.
A URI reference identifying this specific occurrence, typically the request path.
A stable, machine-readable error code. It does not change when detail is reworded, so clients branch on code, never on detail.
Forbidden
{
"type": "https://help.awin.com/apis/error",
"title": "Forbidden",
"status": 403,
"detail": "You do not have the correct privileges to access this resource",
"code": "FORBIDDEN"
}Problem details for an HTTP API error, as defined by RFC 9457. Served as application/problem+json.
A URI reference identifying the problem type. APIs SHOULD define a stable, dereferenceable URI per domain-specific problem type.
A short, human-readable summary of the problem type. Stable across occurrences; does not change from occurrence to occurrence.
The HTTP status code, repeated here for convenience.
A human-readable explanation specific to this occurrence. Intended for the developer, not the end user — do not parse it.
A URI reference identifying this specific occurrence, typically the request path.
A stable, machine-readable error code. It does not change when detail is reworded, so clients branch on code, never on detail.
Too Many Requests
{
"type": "https://help.awin.com/apis/error",
"title": "User rate limit exceeded",
"status": 429,
"detail": "You have exceeded your rate limit across the public API. Retry after the number of seconds in the Retry-After header",
"code": "USER_RATE_LIMIT_EXCEEDED"
}{
"type": "https://help.awin.com/apis/error",
"title": "Route rate limit exceeded",
"status": 429,
"detail": "This endpoint is receiving more requests than it can accept right now. Retry after the number of seconds in the Retry-After header",
"code": "ROUTE_RATE_LIMIT_EXCEEDED"
}{
"type": "https://help.awin.com/apis/error",
"title": "Too Many Requests",
"status": 429,
"detail": "Rate limit exceeded",
"code": "TOO_MANY_REQUESTS"
}Problem details for an HTTP API error, as defined by RFC 9457. Served as application/problem+json.
A URI reference identifying the problem type. APIs SHOULD define a stable, dereferenceable URI per domain-specific problem type.
A short, human-readable summary of the problem type. Stable across occurrences; does not change from occurrence to occurrence.
The HTTP status code, repeated here for convenience.
A human-readable explanation specific to this occurrence. Intended for the developer, not the end user — do not parse it.
A URI reference identifying this specific occurrence, typically the request path.
A stable, machine-readable error code. It does not change when detail is reworded, so clients branch on code, never on detail.
Service Unavailable
{
"type": "https://help.awin.com/apis/error",
"title": "Service Unavailable",
"status": 503,
"detail": "The service is temporarily unavailable",
"code": "SERVICE_UNAVAILABLE"
}Problem details for an HTTP API error, as defined by RFC 9457. Served as application/problem+json.
A URI reference identifying the problem type. APIs SHOULD define a stable, dereferenceable URI per domain-specific problem type.
A short, human-readable summary of the problem type. Stable across occurrences; does not change from occurrence to occurrence.
The HTTP status code, repeated here for convenience.
A human-readable explanation specific to this occurrence. Intended for the developer, not the end user — do not parse it.
A URI reference identifying this specific occurrence, typically the request path.
A stable, machine-readable error code. It does not change when detail is reworded, so clients branch on code, never on detail.
Internal Server Error
{
"type": "https://help.awin.com/apis/error",
"title": "Internal Server Error",
"status": 500,
"detail": "An unexpected error occurred",
"code": "INTERNAL_ERROR"
}Problem details for an HTTP API error, as defined by RFC 9457. Served as application/problem+json.
A URI reference identifying the problem type. APIs SHOULD define a stable, dereferenceable URI per domain-specific problem type.
A short, human-readable summary of the problem type. Stable across occurrences; does not change from occurrence to occurrence.
The HTTP status code, repeated here for convenience.
A human-readable explanation specific to this occurrence. Intended for the developer, not the end user — do not parse it.
A URI reference identifying this specific occurrence, typically the request path.
A stable, machine-readable error code. It does not change when detail is reworded, so clients branch on code, never on detail.