---
title: "Open requests in the petals and regions your licence records cover"
method: GET
path: "/vendor/requests"
tags: ["requests"]
---

# Open requests in the petals and regions your licence records cover

`GET /vendor/requests`

## Request

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

## Query parameters

- `petal_id` string
- `since_ts` integer
- `limit` integer

## Response `200`

Open requests

- object
  - `count` integer, required
  - `requests` OpenRequest[], required
    - `already_bid` boolean, required
    - `created_at` string
    - `expires_at` string, nullable
    - `form_data` object
    - `form_data_parsed` object
    - `id` string, required
    - `petal_id` string, required
    - `region` string, required
    - `urgency` string, nullable
  - `vendor_id` string, required

## Other responses

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

---

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