commerce

GET /v1/orders/{orderId}

Get an order.

すべての commerce エンドポイント

認証

ベアラー トークンとして API キーを送信します。このエンドポイントでは仕様に特定の権限が記載されていないため、キーに必要な最小限の権限を付与し、推測するのではなくレスポンスを確認してください。

このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。

試してみる

アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。

curl -X GET https://api.zinndigital.com/v1/orders/{orderId} \
  -H "Authorization: Bearer zdk_live_…"

ログインしていますか?ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く

詳細

Returns one order with its lines and payment summaries. RBAC + RLS scoped.

パラメータ

名前タイプ必須これがその内容です
orderId (path)UuidはいThe order's id.

返信

名前タイプ必須これがその内容です
idUuidはいUUIDv7 identifier — sortable by creation time (docs/02 §8).
org_idUuidはいUUIDv7 identifier — sortable by creation time (docs/02 §8).
human_refstringはいHuman-friendly order reference.
statusOrderStatusはいAn order's lifecycle state (docs/31 §4.3).
currencyCurrencyCodeはいISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
subtotal_minorintegerはい
tax_minorintegerはい
discount_minorintegerはい
total_minorintegerはい
billing_countryobjectいいえ
placed_atobjectいいえ
created_atstringはい
updated_atstringいいえ
linesOrderLine[]はい
paymentsPayment[]はい

このエンドポイントが返すエラー

401 · 403 · 404 · 429