Webhook

Cart optimizer run completed

​

Fires when a cart-optimizer run finishes successfully. Carries a summary of each option (totals + seller count); fetch GET /v1/optimizer/runs/{id} for the full per-seller breakdown.

Body
required
application/json
  • data
    Type: object
    required
  • eventId
    Type: string
    required

    Idempotency key — stable across delivery retries.

  • timestamp
    Type: string Format: date-time
    required

    An ISO 8601 date-time in UTC, e.g. 2024-08-14T10:23:11.000Z.

  • type
    const:  
    optimizer.run.completed
    required
Responses
  • 2XX

    Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.

Request Example for postoptimizer.run.completed
{
  "type": "optimizer.run.completed",
  "eventId": "opt_9f2c1a7b3d4e5f60.completed",
  "timestamp": "2026-07-08T18:44:23.000Z",
  "data": {
    "runId": "opt_9f2c1a7b3d4e5f60",
    "options": [
      {
        "modes": [
          "lowest_price",
          "fewest_sellers"
        ],
        "sellerCount": 6,
        "total": {
          "amount": 222.65,
          "currency": "USD"
        },
        "subtotal": {
          "amount": 208.49,
          "currency": "USD"
        },
        "shipping": {
          "amount": 5.4,
          "currency": "USD"
        }
      }
    ],
    "unmetCount": 0
  }
}
No Body

Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.