---
title: "JSON Schema of the detailed bid form for a petal"
method: GET
path: "/bids/schema"
tags: ["discovery"]
---

# JSON Schema of the detailed bid form for a petal

`GET /bids/schema`

## Request

- Base URL: `https://justbidit.ai/api/v1`
- URL: `https://justbidit.ai/api/v1/bids/schema`
- Auth: none required

Describes the bid-form fields (amount_cents, pitch, petal fields). POST /vendor/bids takes BidInput; put extra fields in offer_details.

## Query parameters

- `petal` string, required

## Response `200`

JSON Schema (draft 2020-12)

- object

## Other responses

- `400`: `petal_required`

---

[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)