POST /proposal/reject

NOTE: The EPA API has sunset on September 30, 2026. Endpoints are no longer accessible. For alternatives, see EPA to PDP Migration.

Rejects the proposal and returns a new revision in its Rejected state.

Here's what you need to know about rejecting a proposal:

• If a party rejects a non-activated proposal, the proposal returns in the Rejected state, and the deal terms cannot be changed and both parties can no longer accept the proposal terms.
• If a party rejects an activated proposal, the seller can still update the proposal deal terms and both parties can still accept them.

Request example

To reject a proposal, use the POST /proposal/reject endpoint and specify the proposal ID and the current revision number of the proposal.

{
    "ProposalId": 1234,
    "RevisionNumber": 3
}

Request object properties

The following table lists the POST /proposal/reject request object properties.

Response example

A successful response to a POST /proposal/reject request returns a Proposal object with an increased revision number and the ProposalState value set to Rejected.

{
    "ProposalId": 1234,
    "DisplayName": "Test Proposal",
    "RevisionNumber": 4,
    "Buyer": {
        "BuyerId": "5168"
    },
    "Seller": {
        "SellerId": "Test",
        "SellerName": "Test Seller"
    },
    "Deals": [
        {
            "DealId": 5367297813,
            "DisplayName": "Test Deal",
            "ExternalDealId": "4263497813",
            "PublisherIds": [
                "1234"
            ],
            "DealType": "Preferred",
            "PreferredDealTerms": {
                "RateType": "CPM",
                "Rate": {
                    "Amount": 0.05,
                    "CurrencyCode": "USD"
                }
            },
            "CreativeRestrictions": {
                "CreativeFormat": "Display"
            },
            "CreateTime": "2021-08-19T18:53:18.05",
            "UpdateTime": "2021-08-19T18:53:18.05"
        }
    ],
    "Notes": [],
    "Originator": "Seller",
    "LastUpdatedBy": "Seller",
    "ProposalState": "Rejected",
    "SellerAccepted": "false",
    "BuyerAccepted": "false",
    "CreatedTime": "2021-08-19T18:53:18.05",
    "UpdatedTime": "2021-08-20T23:01:41.05"
}

For details on the individual properties, see Proposal object and Deals object.

Error codes and messages

The following table provides a list of common errors and their respective HTTP error codes.