Contracts

Endpoints for retrieving partner contract details and payout terms.

List Contracts

get

Returns a list of all contracts associated with your partner account.

Path parameters

AccountSIDstringRequired

Unique identifier for the partner account.

Query parameters

CampaignIdintegerOptional

Filters contracts by the campaign they belong to.

Statusstring · enumOptional

Return contracts with a specific status. If omitted, only contracts where Status is ACTIVE are returned.

Possible values:

SignatorystringOptional

Return contracts with a particular signatory. Matches against both BrandSignatory and PartnerSignatory.

DateLastUpdatedBeforestring · date-timeOptional

Return contracts last updated before a specific date and time (ISO 8601).

DateLastUpdatedAfterstring · date-timeOptional

Return contracts last updated after a specific date and time (ISO 8601).

StartDateBeforestring · date-timeOptional

Return contracts that start before a specific date and time (ISO 8601).

StartDateAfterstring · date-timeOptional

Return contracts that start after a specific date and time (ISO 8601).

EndDateBeforestring · date-timeOptional

Return contracts that end before a specific date and time (ISO 8601).

EndDateAfterstring · date-timeOptional

Return contracts that end after a specific date and time (ISO 8601).

Responses

200

A list of contract objects.

application/json

get

/Mediapartners/{AccountSID}/Contracts

HTTPcURLJavaScriptPython

GET /Mediapartners/{AccountSID}/Contracts HTTP/1.1
Host: api.impact.com
Accept: */*

200

A list of contract objects.

{
  "Contracts": [
    {
      "Id": "S-37085294",
      "CampaignId": "10306",
      "Status": "ACTIVE",
      "StartDate": "2026-03-01T00:00:00-08:00",
      "EndDate": "",
      "BrandSignatory": "Robin Banks",
      "BrandSignatoryDate": "2026-02-28T23:51:22-08:00",
      "PartnerSignatory": "Carrie Oakey",
      "PartnerSignatoryDate": "2026-02-28T23:51:22-08:00",
      "DateCreated": "2026-02-28T23:51:22-08:00",
      "DateLastUpdated": "2026-02-28T23:51:22-08:00",
      "Terms": {
        "TemplateTermName": "ScheduledTerms Test",
        "Currency": "USD",
        "TemplateId": "text",
        "VersionId": "text",
        "Name": "text",
        "Labels": [
          "text"
        ],
        "EventPayouts": [
          {
            "EventTypeId": "18503",
            "EventTypeName": "Online Sale",
            "EventCategory": "SALE",
            "DefaultPayoutRate": "0",
            "PayoutLevel": "ITEM",
            "DefaultPayout": "text",
            "PayoutGroups": [
              {
                "Id": "94bc1ae3-5f77-4e63-a862-3bbcf7f085dd",
                "Rank": "1",
                "Rules": [
                  {
                    "Variable": "CUSTOMER_STATUS",
                    "Operator": "IS",
                    "Values": [
                      "EXISTING"
                    ]
                  }
                ],
                "PayoutRate": "15",
                "Payout": "0.10",
                "Limits": [
                  {
                    "Type": "text",
                    "Value": "text",
                    "LimitBy": "text",
                    "Period": "text",
                    "WeekendOverrideValue": "text"
                  }
                ]
              }
            ],
            "PayoutRestrictions": [
              {
                "Id": "text",
                "Rules": [
                  {
                    "Variable": "CUSTOMER_STATUS",
                    "Operator": "IS",
                    "Values": [
                      "EXISTING"
                    ]
                  }
                ],
                "ZeroPayoutHideReport": "text"
              }
            ],
            "Limits": [
              {
                "Type": "text",
                "Value": "text",
                "LimitBy": "text",
                "Period": "text",
                "WeekendOverrideValue": "text"
              }
            ],
            "PayoutAdjustments": [
              {
                "Id": "8c281c2e-f61e-4b11-a9f9-9be38c79fe9e",
                "Rules": [
                  {
                    "Variable": "CUSTOMER_STATUS",
                    "Operator": "IS",
                    "Values": [
                      "EXISTING"
                    ]
                  }
                ],
                "Direction": "INCREASE",
                "Rate": "0"
              }
            ],
            "PerformanceBonus": {
              "Type": "SUBSEQUENT_ACTIONS",
              "Basis": "REVENUE",
              "Period": "CALENDAR_MONTH",
              "Tiers": [
                {
                  "RevenueThreshold": "1000000.00",
                  "PayoutRate": "0"
                }
              ]
            },
            "Locking": {
              "Basis": "TRACKED",
              "Period": "MONTH",
              "MonthOffset": "1",
              "DayOffset": "0"
            },
            "PayoutScheduling": {
              "Basis": "LOCKED",
              "Period": "END_OF_DAY"
            },
            "CreditPolicy": "LAST_REFERRER",
            "ValidReferrals": [
              {
                "Type": "CLICKS",
                "Window": "30",
                "WindowUnit": "DAY"
              }
            ]
          }
        ],
        "SpecialTermsList": [
          {
            "TermsName": "Custom Terms",
            "TermsType": "CUSTOM",
            "TermsContent": "<p>Custom terms and conditions content.</p>"
          }
        ],
        "ChangeNotificationPeriod": "0",
        "ReturnPolicy": "ALWAYS_OK",
        "MaxReturnPercentage": "100",
        "CustomCreativePayer": "ADVERTISER",
        "ActionLimit": "text",
        "ActionLimitPeriod": "text",
        "SpendLimit": "text",
        "SpendLimitPeriod": "text",
        "MinEarningPerClick": "text",
        "ContractStartSlottingFee": "text"
      },
      "HasCampaignTerms": true,
      "CampaignTerms": [
        {
          "Id": "3578",
          "Name": "ForgeMaster Anvils at Acme SuperCenter - Product Boost",
          "StartDate": "2025-08-16T00:00:00-07:00",
          "EndDate": "2029-08-31T23:59:59-07:00",
          "EventPayouts": [
            {
              "EventTypeId": "18503",
              "PayoutLevel": "ITEM",
              "PayoutGroups": [
                {
                  "Id": "94bc1ae3-5f77-4e63-a862-3bbcf7f085dd",
                  "Rank": "1",
                  "Rules": [
                    {
                      "Variable": "CUSTOMER_STATUS",
                      "Operator": "IS",
                      "Values": [
                        "EXISTING"
                      ]
                    }
                  ],
                  "PayoutRate": "15",
                  "Payout": "0.10",
                  "Limits": [
                    {
                      "Type": "text",
                      "Value": "text",
                      "LimitBy": "text",
                      "Period": "text",
                      "WeekendOverrideValue": "text"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "PdfUri": "/Mediapartners/<AccountSID>/Campaigns/10306/Contracts/S-37085294/Download",
      "Uri": "/Mediapartners/<AccountSID>/Contracts/S-37085294"
    }
  ]
}

Retrieve a Contract

get

'Retrieves the full details of an existing contract using its unique

Note: To retrieve ScheduledTerms and CampaignTerms objects, either upgrade your API version to the latest or append ?IRVersion=15 to your cURL request. ID, including complete campaign-level term overrides. The PdfUri field in the response can be used to download a PDF copy of the contract.'

Path parameters

AccountSIDstringRequired

Unique identifier for the partner account.

IdstringRequired

The unique identifier for the contract.

Responses

200

The contract object.

application/json

IdstringOptional

Unique identifier for the contract.

Example: S-37085294

CampaignIdstringOptional

Unique identifier for the campaign this contract is associated with.

Example: 10306

StatusstringOptional

The current status of the contract (e.g., ACTIVE, PENDING, EXPIRED, TERMINATED).

Example: ACTIVE

StartDatestring · date-timeOptional

The date and time the contract becomes effective (ISO 8601).

Example: 2026-03-01T00:00:00-08:00

EndDatestring · date-timeOptional

The date and time the contract expires (ISO 8601). Empty if the contract has no end date.

BrandSignatorystringOptional

Name of the brand representative who signed the contract.

Example: Robin Banks

BrandSignatoryDatestring · date-timeOptional

Date and time the brand signatory signed the contract (ISO 8601).

Example: 2026-02-28T23:51:22-08:00

PartnerSignatorystringOptional

Name of the partner representative who signed the contract.

Example: Carrie Oakey

PartnerSignatoryDatestring · date-timeOptional

Date and time the partner signatory signed the contract (ISO 8601).

Example: 2026-02-28T23:51:22-08:00

DateCreatedstring · date-timeOptional

Date and time the contract was created (ISO 8601).

Example: 2026-02-28T23:51:22-08:00

DateLastUpdatedstring · date-timeOptional

Date and time the contract was last updated (ISO 8601).

Example: 2026-02-28T23:51:22-08:00

HasCampaignTermsbooleanOptional

Whether this contract includes campaign-level term overrides. Returned by List Contracts. Use Retrieve a Contract to get the full CampaignTerms details.

Example: true

PdfUristringOptional

API resource path for downloading a PDF copy of the contract.

Example: /Mediapartners/<AccountSID>/Campaigns/10306/Contracts/S-37085294/Download

UristringOptional

Unique reference to the contract object in the impact.com API.

Example: /Mediapartners/<AccountSID>/Contracts/S-37085294

get

/Mediapartners/{AccountSID}/Contracts/{Id}

HTTPcURLJavaScriptPython

GET /Mediapartners/{AccountSID}/Contracts/{Id} HTTP/1.1
Host: api.impact.com
Accept: */*

200

The contract object.

{
  "Id": "S-37085294",
  "CampaignId": "10306",
  "Status": "ACTIVE",
  "StartDate": "2026-03-01T00:00:00-08:00",
  "EndDate": "",
  "BrandSignatory": "Robin Banks",
  "BrandSignatoryDate": "2026-02-28T23:51:22-08:00",
  "PartnerSignatory": "Carrie Oakey",
  "PartnerSignatoryDate": "2026-02-28T23:51:22-08:00",
  "DateCreated": "2026-02-28T23:51:22-08:00",
  "DateLastUpdated": "2026-02-28T23:51:22-08:00",
  "Terms": {
    "TemplateTermName": "ScheduledTerms Test",
    "Currency": "USD",
    "TemplateId": "text",
    "VersionId": "text",
    "Name": "text",
    "Labels": [
      "text"
    ],
    "EventPayouts": [
      {
        "EventTypeId": "18503",
        "EventTypeName": "Online Sale",
        "EventCategory": "SALE",
        "DefaultPayoutRate": "0",
        "PayoutLevel": "ITEM",
        "DefaultPayout": "text",
        "PayoutGroups": [
          {
            "Id": "94bc1ae3-5f77-4e63-a862-3bbcf7f085dd",
            "Rank": "1",
            "Rules": [
              {
                "Variable": "CUSTOMER_STATUS",
                "Operator": "IS",
                "Values": [
                  "EXISTING"
                ]
              }
            ],
            "PayoutRate": "15",
            "Payout": "0.10",
            "Limits": [
              {
                "Type": "text",
                "Value": "text",
                "LimitBy": "text",
                "Period": "text",
                "WeekendOverrideValue": "text"
              }
            ]
          }
        ],
        "PayoutRestrictions": [
          {
            "Id": "text",
            "Rules": [
              {
                "Variable": "CUSTOMER_STATUS",
                "Operator": "IS",
                "Values": [
                  "EXISTING"
                ]
              }
            ],
            "ZeroPayoutHideReport": "text"
          }
        ],
        "Limits": [
          {
            "Type": "text",
            "Value": "text",
            "LimitBy": "text",
            "Period": "text",
            "WeekendOverrideValue": "text"
          }
        ],
        "PayoutAdjustments": [
          {
            "Id": "8c281c2e-f61e-4b11-a9f9-9be38c79fe9e",
            "Rules": [
              {
                "Variable": "CUSTOMER_STATUS",
                "Operator": "IS",
                "Values": [
                  "EXISTING"
                ]
              }
            ],
            "Direction": "INCREASE",
            "Rate": "0"
          }
        ],
        "PerformanceBonus": {
          "Type": "SUBSEQUENT_ACTIONS",
          "Basis": "REVENUE",
          "Period": "CALENDAR_MONTH",
          "Tiers": [
            {
              "RevenueThreshold": "1000000.00",
              "PayoutRate": "0"
            }
          ]
        },
        "Locking": {
          "Basis": "TRACKED",
          "Period": "MONTH",
          "MonthOffset": "1",
          "DayOffset": "0"
        },
        "PayoutScheduling": {
          "Basis": "LOCKED",
          "Period": "END_OF_DAY"
        },
        "CreditPolicy": "LAST_REFERRER",
        "ValidReferrals": [
          {
            "Type": "CLICKS",
            "Window": "30",
            "WindowUnit": "DAY"
          }
        ]
      }
    ],
    "SpecialTermsList": [
      {
        "TermsName": "Custom Terms",
        "TermsType": "CUSTOM",
        "TermsContent": "<p>Custom terms and conditions content.</p>"
      }
    ],
    "ChangeNotificationPeriod": "0",
    "ReturnPolicy": "ALWAYS_OK",
    "MaxReturnPercentage": "100",
    "CustomCreativePayer": "ADVERTISER",
    "ActionLimit": "text",
    "ActionLimitPeriod": "text",
    "SpendLimit": "text",
    "SpendLimitPeriod": "text",
    "MinEarningPerClick": "text",
    "ContractStartSlottingFee": "text"
  },
  "HasCampaignTerms": true,
  "CampaignTerms": [
    {
      "Id": "3578",
      "Name": "ForgeMaster Anvils at Acme SuperCenter - Product Boost",
      "StartDate": "2025-08-16T00:00:00-07:00",
      "EndDate": "2029-08-31T23:59:59-07:00",
      "EventPayouts": [
        {
          "EventTypeId": "18503",
          "PayoutLevel": "ITEM",
          "PayoutGroups": [
            {
              "Id": "94bc1ae3-5f77-4e63-a862-3bbcf7f085dd",
              "Rank": "1",
              "Rules": [
                {
                  "Variable": "CUSTOMER_STATUS",
                  "Operator": "IS",
                  "Values": [
                    "EXISTING"
                  ]
                }
              ],
              "PayoutRate": "15",
              "Payout": "0.10",
              "Limits": [
                {
                  "Type": "text",
                  "Value": "text",
                  "LimitBy": "text",
                  "Period": "text",
                  "WeekendOverrideValue": "text"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "PdfUri": "/Mediapartners/<AccountSID>/Campaigns/10306/Contracts/S-37085294/Download",
  "Uri": "/Mediapartners/<AccountSID>/Contracts/S-37085294"
}