---
title: "Bid Events"
method: POST
path: "/bid-webhooks"
tags: ["Webhooks"]
---

# Bid Events

`POST /bid-webhooks`

Posts a message when an event about a Bid is triggered.
The bid event payload has the same schema for all bid event types.

## Request body

- union
  - object
    - `details` object
      - `id` string, uuid — Bid unique identifier (UUID)
      - `offer_id` string, uuid — Offer unique identifier (UUID)
      - `price` string, uuid — Bid price (USD).
      - `created_at` string, date-time — Bid creation datetime
      - `expires_at` string, date-time — The bid expiration datetime
      - `expired_at` string, date-time — The bid datetime that bid was expirated
      - `status` 'pending' | 'awarded' | 'accepted' | 'timed_out' | 'refused' — Bid status.
    - `created_at` string, date-time — The date and time of the event.
    - `type` 'bid:expired' | 'bid:timed_out' | 'bid:refused' | 'bid:awarded' | 'bid:accepted' — Event type
  - object
    - `details` object
      - `id` string, uuid — Bid unique identifier (UUID)
      - `offer_id` string, uuid — Offer unique identifier (UUID)
      - `price` string, uuid — Bid price (USD).
      - `created_at` string, date-time — Bid creation datetime
      - `expires_at` string, date-time — The bid expiration datetime
      - `expired_at` string, date-time — The bid datetime that bid was expirated
      - `status` 'pending' | 'awarded' | 'accepted' | 'timed_out' | 'refused' — Bid status.
    - `created_at` string, date-time — The date and time of the event.
    - `type` 'bid:expired' | 'bid:timed_out' | 'bid:refused' | 'bid:awarded' | 'bid:accepted' — Event type
  - object
    - `details` object
      - `id` string, uuid — Bid unique identifier (UUID)
      - `offer_id` string, uuid — Offer unique identifier (UUID)
      - `price` string, uuid — Bid price (USD).
      - `created_at` string, date-time — Bid creation datetime
      - `expires_at` string, date-time — The bid expiration datetime
      - `expired_at` string, date-time — The bid datetime that bid was expirated
      - `status` 'pending' | 'awarded' | 'accepted' | 'timed_out' | 'refused' — Bid status.
    - `created_at` string, date-time — The date and time of the event.
    - `type` 'bid:expired' | 'bid:timed_out' | 'bid:refused' | 'bid:awarded' | 'bid:accepted' — Event type
  - object
    - `details` object
      - `id` string, uuid — Bid unique identifier (UUID)
      - `offer_id` string, uuid — Offer unique identifier (UUID)
      - `price` string, uuid — Bid price (USD).
      - `created_at` string, date-time — Bid creation datetime
      - `expires_at` string, date-time — The bid expiration datetime
      - `expired_at` string, date-time — The bid datetime that bid was expirated
      - `status` 'pending' | 'awarded' | 'accepted' | 'timed_out' | 'refused' — Bid status.
    - `created_at` string, date-time — The date and time of the event.
    - `type` 'bid:expired' | 'bid:timed_out' | 'bid:refused' | 'bid:awarded' | 'bid:accepted' — Event type
  - object
    - `details` object
      - `id` string, uuid — Bid unique identifier (UUID)
      - `offer_id` string, uuid — Offer unique identifier (UUID)
      - `price` string, uuid — Bid price (USD).
      - `created_at` string, date-time — Bid creation datetime
      - `expires_at` string, date-time — The bid expiration datetime
      - `expired_at` string, date-time — The bid datetime that bid was expirated
      - `status` 'pending' | 'awarded' | 'accepted' | 'timed_out' | 'refused' — Bid status.
    - `created_at` string, date-time — The date and time of the event.
    - `type` 'bid:expired' | 'bid:timed_out' | 'bid:refused' | 'bid:awarded' | 'bid:accepted' — Event type
  - object
    - `details` object
      - `id` string, uuid — Bid unique identifier (UUID)
      - `offer_id` string, uuid — Offer unique identifier (UUID)
      - `price` string, uuid — Bid price (USD).
      - `created_at` string, date-time — Bid creation datetime
      - `expires_at` string, date-time — The bid expiration datetime
      - `expired_at` string, date-time — The bid datetime that bid was expirated
      - `status` 'pending' | 'awarded' | 'accepted' | 'timed_out' | 'refused' — Bid status.
    - `created_at` string, date-time — The date and time of the event.
    - `type` string — Event type

## Response `200`

Event received

---

[API](https://skmtc.dev/loadsmart/apis/loadsmart-api.md) · [All operations](https://skmtc.dev/loadsmart/apis/loadsmart-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loadsmart/loadsmart-api/revisions/6021c5806fe9/schema)