GET /proposal/history/{ProposalId}/{RevisionNumber}

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

Retrieves the revision of an existing proposal for the specified proposal ID and revision number.

Path parameters

The following table lists the path parameters for this endpoint.

Property Required? Value Type Description
ProposalId Required Integer The unique ID of the proposal that you want to retrieve.
RevisionNumber Required Integer The revision number of the proposal that you want to retrieve. See also the Revisions section in Easy Proposal Activation API.

Response example

A successful response to the GET /proposal/history/{ProposalId}/{RevisionNumber} endpoint returns a Proposal object of the requested revision.

{
    "ProposalId": 1234,
    "DisplayName": "Test Proposal",
    "RevisionNumber": 3,
    "LastActivatedRevisionNumber": 2,
    "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"
            }
        }
    ],
    "Notes": [],
    "Originator": "Seller",
    "LastUpdatedBy": "Seller",
    "ProposalState": "Proposed",
    "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.

HTTP Code Status Description
404 Not Found The proposal or revision does not exist.
410 Gone The proposal has been deleted by the buyer or seller.