Outcomes

Poll bid-outcome events (for clients without webhooks)

The MCP get_offer_events tool. The ordered log of bid-outcome events — the same events webhooks deliver — for one quote (quoteId) or for every quote this caller owns (omit it). Pass since = the previous response's nextCursor (or an ISO timestamp) to receive only what's new. A quote whose traveler hasn't completed the check yet returns an empty page, not 409.

get/api/v1/offers/events

Request

  • Base URL: https://www.upgradeagent.ai
  • URL: https://www.upgradeagent.ai/api/v1/offers/events
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://www.upgradeagent.ai/api/oauth/authorize, token URL https://www.upgradeagent.ai/api/oauth/token, scopes: mcp)
    • HTTP bearer

Query parameters

quoteIdstring

Limit to one quote the caller owns.

sincestring

A nextCursor from a previous response, or an ISO-8601 timestamp.

limitinteger

1–200, default 50.

Response

Events, oldest first, with the cursor for the next poll.

quoteIdstring nullable required

The quote filtered on, or null for all of the caller's quotes.

nextCursorstring nullable required

Pass as since on the next call; null when no events were returned.

eventTypesstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.