Skip to main content
POST
Confirm the buyer still wants a Request

Authorizations

Authorization
string
header
required

An OAuth access token for the buyer resource (audience, issuer and signature checked). Its scopes and the active grant the person approved are both enforced.

Headers

Idempotency-Key
string
required

Stable key for one logical write. 8–64 characters. Reusing it with different input returns 409.

Required string length: 8 - 64
API-Version
string
default:2026-11-20

Current contract only; no version negotiation. See https://docs.populardemand.market/api-reference/introduction.

Path Parameters

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json
expected_version
integer
required
Required range: x <= 9007199254740991

Response

Private result; no-store/noindex. No payment or executable order is implied.

blockers
string[]
required
next_actions
object[]
required
as_of
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
status
enum<string>
required
Available options:
draft,
active,
closed
version
integer
required
Required range: x <= 9007199254740991
original_raw_request
string
required
raw_request
string
required
country
enum<string>
required
Available options:
US,
IL
Pattern: ^[A-Z]{2}$
currency
enum<string>
required
Available options:
USD,
ILS
Pattern: ^[A-Z]{3}$
destination
object
required
time_horizon
string | null
required
need_by
string<date-time> | null
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
items
object[]
required
price_limits
object[]
required
delivery
enum<string>[]
required
Available options:
shipping,
pickup
all_items_required
boolean | null
required
resolution_status
enum<string>
required
Available options:
unresolved,
proposed,
resolved
research_status
enum<string>
required
Available options:
needs_research,
provisional,
reviewed
source
string
required
created_via
enum<string>
required
Available options:
web,
api,
agent,
email
origin_client_id
string | null
required
Maximum string length: 2048
created_at
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
updated_at
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
expires_at
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
activated_at
string<date-time> | null
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
last_reaffirmed_at
string<date-time> | null
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
closed_at
string<date-time> | null
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
closed_reason
string | null
required
observations
object[]
required
baseline
object | null
required
pricing
object
required
baseline_diagnostics
object
required
execution_available
boolean
required
execution_note
string
required
reachability
object[]
required
agent_events
object[]
required
polling_access
object[]
required
email_delivery
enum<string>
required
Available options:
local_inbox,
configured,
unconfigured
history
object[]
required
compatible_demand
object[]
required
buyer_status
object
exact_item_confirmation
object | null
draft_agent
string | null

While this is a draft an email agent sent: that agent's mailbox, which activation can make a delegate for this Request. Null otherwise.

offer_email
object
possible_duplicate_of
object[]

Open Requests of the same owner that closely match this new one: the same exact product references, the same top Need option set or the same words, with an overlapping destination. The new Request was saved anyway. If one is for the same thing, ask the person which to keep, then update or close the other so they are counted once.

Maximum array length: 5
duplicate_hint
string | null
save_confirmation
object
needs_attention
enum<string>[]
Available options:
new_offer,
open_question,
details_needed,
still_want,
offer_ending
attention
object[]

Each needs_attention flag in words.

next_step
string | null

The one next step, or null.

message
string

What to tell the person.

agent_line
string

What the agent does next.

open_questions
object[]

Questions to answer with POST /api/purchases/{id}/answers before their deadline.

notifications
object
supplier_text_is_untrusted
boolean
untrusted_text_fields
string[]
Maximum array length: 20