---
title: "AI draft of a bid for one request. Submits nothing"
method: POST
path: "/vendor/bids/draft"
tags: ["bids"]
---

# AI draft of a bid for one request. Submits nothing

`POST /vendor/bids/draft`

## Request

- Base URL: `https://justbidit.ai/api/v1`
- URL: `https://justbidit.ai/api/v1/vendor/bids/draft`
- Auth: API key in header `X-Vendor-API-Key`

## Request body

- object
  - `request_id` string, required

## Response `200`

Draft for you to review and price yourself

- object
  - `already_bid` boolean
  - `draft` object
    - `confidence` string
    - `currency` string
    - `delivery_days` integer, nullable
    - `pitch` string
    - `pricing_note` string
    - `reasoning` string
    - `suggested_amount` number, nullable
  - `note` string
  - `ok` boolean
  - `request_id` string

## Other responses

- `400`: `missing_request_id`
- `401`: `auth_required`: the X-Vendor-API-Key header is missing
- `403`: `invalid_key`: the key is unknown or revoked
- `404`: `request_not_found_or_not_eligible`
- `429`: `rate_limited`: over the per-key limit (default 60 requests/minute)
- `502`: `draft_failed`

---

[API](https://skmtc.dev/justbidit/apis/bidit-vendor-api.md) · [All operations](https://skmtc.dev/justbidit/apis/bidit-vendor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/justbidit/apis/bidit-vendor-api/revisions/b21a33733026?raw)