Method: buyers.proposals.accept

Accepts the proposal at the given revision number. If the revision number in the request is behind the latest from the server, an error message will be returned. This call updates the Proposal.state from BUYER_ACCEPTANCE_REQUESTED to FINALIZED; it has no side effect if the Proposal.state is already FINALIZED and throws exception if the Proposal.state is not either BUYER_ACCEPTANCE_REQUESTED or FINALIZED. Accepting a proposal means the buyer understands and accepts the Proposal.terms_and_conditions proposed by the seller.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Name of the proposal. Format: buyers/{accountId}/proposals/{proposalId}

Request body

The request body contains data with the following structure:

JSON representation
  "proposalRevision": string

string (int64 format)

The last known client revision number of the proposal.

Response body

If successful, the response body contains an instance of Proposal.

Authorization scopes

Requires the following OAuth scope: