Skip to main content
POST
Find a customer's earlier orders

Authorizations

X-API-Key
string
header
required

Your ProvenMetal API key (pm_live_...). Authorization: Bearer <key> also works.

Body

application/json

Everything the MCP previous_orders tool takes: the email alone asks for a code, the email and the code list the orders, and history_token alone lists them again.

email
string | null

The email the customer ordered with, as they gave it; never guess one.

Maximum string length: 254
code
string | null

The 6-digit code from ProvenMetal's email.

Maximum string length: 12
history_token
string | null

From an earlier reply: lists the orders again for 60 minutes.

Maximum string length: 200

Response

Successful Response

ok
boolean
required
sent_to
string | null

After the email alone: where the code went, partly hidden.

expires_in_minutes
integer | null
history_token
string | null

For POST /v1/reorders and to list the orders again, 60 minutes.

orders
Orders · object[] | null

The customer's own paid or requested orders: each order_id, board options, quantity, BOM choices (customer-supplied and unfitted parts, approved substitutions, ProvenMetal picking parts), delivery and files.