Retrieve a single order by its order id — the identifier assigned by the order’s source
(your store platform, or the order_id you sent to POST /v1/orders/placed).
Order ids are unique per source. In the rare case two sources share an id, the most recently created order is returned.
A /v1/orders row already carries the whole order, so this is for an id
that came from somewhere else rather than a follow-up read.
Target a subaccount instead of the main connected account.
Pass a subaccount id from get_account's subaccounts list. Only direct subaccounts
of the connected account are reachable — omit this for the main account itself.
An order as persisted. Echoes back the fields you sent
(column-backed fields normalized, the rest verbatim).
Empty values are omitted from the response.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Privy Knowledge Base","colors":{"primary":"#254E5A","light":"#E3E32B","dark":"#254E5A"},"logo":{"light":"https://mintcdn.com/privy/fGrkZt933tBjY_zl/logo/light.svg?fit=max\u0026auto=format\u0026n=fGrkZt933tBjY_zl\u0026q=85\u0026s=36a01db426b7c94fac423778765cd517","dark":"https://mintcdn.com/privy/fGrkZt933tBjY_zl/logo/dark.svg?fit=max\u0026auto=format\u0026n=fGrkZt933tBjY_zl\u0026q=85\u0026s=24576b53a928bf065f4a636ab8dc3431"},"favicon":"https://mintcdn.com/privy/fGrkZt933tBjY_zl/logo/favicon.svg?fit=max\u0026auto=format\u0026n=fGrkZt933tBjY_zl\u0026q=85\u0026s=9fee6eb5a3c74b929294365e07a3f01d","background":{"color":{"light":"#FFF","dark":"#0D1D23"}},"navbar":{"links":[{"href":"https://www.privy.com/pricing","label":"Pricing"},{"href":"mailto:support@privy.com","label":"Contact Support"}],"primary":{"type":"button","label":"Login","href":"https://dashboard.privy.com"}},"footer":{"socials":{"x":"https://x.com/privy","linkedin":"https://www.linkedin.com/company/privy"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"Matter","weight":650,"source":"https://public-assets.privy.com/MatterStandard-VF.woff2","format":"woff2"},"body":{"family":"Matter","weight":400,"source":"https://public-assets.privy.com/MatterStandard-VF.woff2","format":"woff2"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"privy","hasAudioNarration":false,"actualSubdomain":"privy","customDomains":["help.privy.com"],"gitSource":{"type":"github","owner":"privy","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3ac7069be62302954224f","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Learn","count":275},{"language":"default","tag":"Developer","count":49},{"language":"default","tag":"Integrations","count":30},{"language":"default","tag":"Strategy Guides","count":24},{"language":"default","tag":"Flows","count":18},{"language":"default","tag":"Account + Billing","count":18},{"language":"default","tag":"Contacts","count":17},{"language":"default","tag":"Displays","count":15},{"language":"default","tag":"Deliverability","count":11},{"language":"default","tag":"Content","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"Matter\";src:url(\"https://public-assets.privy.com/MatterStandard-VF.woff2\") format(\"woff2\");font-display:swap;font-style:normal;font-weight:600}.mdx-content strong,.mdx-content b{font-weight:600}.mdx-content em,.mdx-content i{font-style:italic}"}],"page":{"pagePath":"docs/api-reference/get-order","slug":"/docs/api-reference/get-order","pageMetadata":{"title":"Get an order","openapi":"openapi/privy-api.yaml GET /orders/{order_id}","description":"Retrieve a single order by its order id — the identifier assigned by the order's source\n(your store platform, or the `order_id` you sent to `POST /v1/orders/placed`).\n\nOrder ids are unique per source. In the rare case two sources share an id, the most recently created order is returned.\n\nA `/v1/orders` row already carries the whole order, so this is for an id\nthat came from somewhere else rather than a follow-up read.\n\n**Required scope:** `orders_read`\n","href":"/docs/api-reference/get-order"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Retrieve a single order by its order id — the identifier assigned by the order’s source\\n(your store platform, or the \", _jsx(_components.code, {\n children: \"order_id\"\n }), \" you sent to \", _jsx(_components.code, {\n children: \"POST /v1/orders/placed\"\n }), \").\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Order ids are unique per source. In the rare case two sources share an id, the most recently created order is returned.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A \", _jsx(_components.code, {\n children: \"/v1/orders\"\n }), \" row already carries the whole order, so this is for an id\\nthat came from somewhere else rather than a follow-up read.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Required scope:\"\n }), \" \", _jsx(_components.code, {\n children: \"orders_read\"\n })]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get an order","openapi":"openapi/privy-api.yaml GET /orders/{order_id}","description":"Retrieve a single order by its order id — the identifier assigned by the order's source\n(your store platform, or the `order_id` you sent to `POST /v1/orders/placed`).\n\nOrder ids are unique per source. In the rare case two sources share an id, the most recently created order is returned.\n\nA `/v1/orders` row already carries the whole order, so this is for an id\nthat came from somewhere else rather than a follow-up read.\n\n**Required scope:** `orders_read`\n","href":"/docs/api-reference/get-order"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getOrder","summary":"Get an order","description":"Retrieve a single order by its order id — the identifier assigned by the order's source\n(your store platform, or the `order_id` you sent to `POST /v1/orders/placed`).\n\nOrder ids are unique per source. In the rare case two sources share an id, the most recently created order is returned.\n\nA `/v1/orders` row already carries the whole order, so this is for an id\nthat came from somewhere else rather than a follow-up read.\n\n**Required scope:** `orders_read`\n","tags":["Orders"],"security":["339e6a38-b368-4f3b-a2fa-aa789ad2e277"],"parameters":["dab0b8be-e219-4dc0-ac0f-e53854d0e543","09448db7-5e23-4819-ba15-deb1cc88abc2"],"responses":{"200":"846c8a02-d76c-4477-b5e5-0d5852f60c7a","401":"dda1fb74-6c27-4672-97b2-9fc25254397b","403":"cf79f309-285c-4c33-8414-59b5eb5552d9","404":"843eff03-86c3-4e58-bc99-4ba5d6121b86","429":"18cea654-dfeb-4e3f-a8bc-5a144b19c647"},"method":"get","type":"path","servers":["97f63e03-f020-41b7-a5b9-e312bbfed47d"],"path":"/orders/{order_id}","baseUrlOptions":["https://api.privy.com/v1"],"title":"Get an order","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dab0b8be-e219-4dc0-ac0f-e53854d0e543":{"name":"Privy-Account-Id","in":"header","required":false,"description":"Target a subaccount instead of the main connected account.\nPass a subaccount `id` from get_account's `subaccounts` list. Only direct subaccounts\nof the connected account are reachable — omit this for the main account itself.\n","schema":{"type":"string","isRequired":false,"description":"Target a subaccount instead of the main connected account.\nPass a subaccount `id` from get_account's `subaccounts` list. Only direct subaccounts\nof the connected account are reachable — omit this for the main account itself.\n","uniqueKey":"","typeLabel":"string"},"example":"S1U2B3A4C5C6T7"},"09448db7-5e23-4819-ba15-deb1cc88abc2":{"name":"order_id","in":"path","required":true,"description":"The order's source-assigned id (returned as `order_id` in order responses).","schema":{"type":"integer","format":"int64","isRequired":true,"description":"The order's source-assigned id (returned as `order_id` in order responses).","uniqueKey":"","typeLabel":"integer\u003cint64>"},"example":1001}},"responses":{"846c8a02-d76c-4477-b5e5-0d5852f60c7a":{"description":"The order.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"An order as persisted. Echoes back the fields you sent\n(column-backed fields normalized, the rest verbatim).\nEmpty values are omitted from the response.\n","properties":{"order_id":{"type":"integer","format":"int64","description":"Your order identifier, echoed back. The only public identifier for the order.","example":1001,"uniqueKey":"data.order_id","typeLabel":"integer\u003cint64>"},"source":{"type":"string","example":"api","uniqueKey":"data.source","typeLabel":"string"},"email":{"type":"string","format":"email","example":"buyer@example.com","uniqueKey":"data.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Normalized to E.164.","example":"+12025550123","uniqueKey":"data.phone","typeLabel":"string"},"total_amount":{"type":"string","description":"Order grand total, as a decimal string.","example":"95.00","uniqueKey":"data.total_amount","typeLabel":"string"},"currency_code":{"type":"string","example":"USD","uniqueKey":"data.currency_code","typeLabel":"string"},"placed_at":{"type":"string","format":"date-time","example":"2026-06-01T12:00:00Z","uniqueKey":"data.placed_at","typeLabel":"string\u003cdate-time>"},"financial_status":{"type":"string","description":"Payment status of the order, using Shopify's order financial-status vocabulary. Absent when\nno payment status was recorded for the order.\n","example":"paid","uniqueKey":"data.financial_status","typeLabel":"string"},"fulfillment_status":{"type":"string","description":"The order's overall fulfillment state — where the order sits in the store's fulfillment\nprocess. Delivery-based flow triggers key off `shipment_status`, not this field.\n","example":"fulfilled","uniqueKey":"data.fulfillment_status","typeLabel":"string"},"shipment_status":{"type":"string","description":"Carrier delivery status of the shipment — where the parcel is. Privy acts on this field:\nwhen it becomes `delivered`, the contact's \"Order Received\" flows start.\n","example":"in_transit","uniqueKey":"data.shipment_status","typeLabel":"string"},"customer_id":{"oneOf":[{"type":"string","description":"The customer identifier reported with the order, echoed back as sent.\n","example":"ext-42","uniqueKey":"data.customer_id.oneOf.0","typeLabel":"string"},{"type":"integer","description":"The customer identifier reported with the order, echoed back as sent.\n","example":"ext-42","uniqueKey":"data.customer_id.oneOf.1","typeLabel":"integer"}],"uniqueKey":"data.customer_id","typeLabel":"string | integer"},"subtotal":{"type":"number","example":90,"uniqueKey":"data.subtotal","typeLabel":"number"},"discounts":{"type":"array","items":{"type":"object","description":"A discount applied to the order. Stored and echoed back verbatim.","additionalProperties":true,"properties":{"code":{"oneOf":[{"type":"string","example":"SAVE10","uniqueKey":"data.discounts.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","example":"SAVE10","uniqueKey":"data.discounts.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.discounts.items.[INDEX].code","typeLabel":"string | null"},"amount":{"oneOf":[{"type":"number","example":10,"uniqueKey":"data.discounts.items.[INDEX].amount.oneOf.0","typeLabel":"number"},{"type":"null","example":10,"uniqueKey":"data.discounts.items.[INDEX].amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.discounts.items.[INDEX].amount","typeLabel":"number | null"}},"uniqueKey":"data.discounts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.discounts","typeLabel":"object[]"},"tax_lines":{"type":"array","items":{"type":"object","description":"A tax line on the order. Stored and echoed back verbatim.","additionalProperties":true,"properties":{"title":{"oneOf":[{"type":"string","example":"VAT","uniqueKey":"data.tax_lines.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","example":"VAT","uniqueKey":"data.tax_lines.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.tax_lines.items.[INDEX].title","typeLabel":"string | null"},"amount":{"oneOf":[{"type":"number","example":5,"uniqueKey":"data.tax_lines.items.[INDEX].amount.oneOf.0","typeLabel":"number"},{"type":"null","example":5,"uniqueKey":"data.tax_lines.items.[INDEX].amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.tax_lines.items.[INDEX].amount","typeLabel":"number | null"}},"uniqueKey":"data.tax_lines.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.tax_lines","typeLabel":"object[]"},"total_items":{"type":"integer","example":2,"uniqueKey":"data.total_items","typeLabel":"integer"},"line_items":{"type":"array","items":{"type":"object","description":"A product line on the order. Stored and echoed back verbatim.","additionalProperties":true,"properties":{"product_id":{"oneOf":[{"type":"string","example":"prod_305","uniqueKey":"data.line_items.items.[INDEX].product_id.oneOf.0","typeLabel":"string"},{"type":"number","example":"prod_305","uniqueKey":"data.line_items.items.[INDEX].product_id.oneOf.1","typeLabel":"number"}],"uniqueKey":"data.line_items.items.[INDEX].product_id","typeLabel":"string | number"},"variant_id":{"oneOf":[{"type":"string","example":"var_305","uniqueKey":"data.line_items.items.[INDEX].variant_id.oneOf.0","typeLabel":"string"},{"type":"number","example":"var_305","uniqueKey":"data.line_items.items.[INDEX].variant_id.oneOf.1","typeLabel":"number"}],"uniqueKey":"data.line_items.items.[INDEX].variant_id","typeLabel":"string | number"},"sku":{"oneOf":[{"type":"string","example":"SKU-1","uniqueKey":"data.line_items.items.[INDEX].sku.oneOf.0","typeLabel":"string"},{"type":"null","example":"SKU-1","uniqueKey":"data.line_items.items.[INDEX].sku.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.line_items.items.[INDEX].sku","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","example":"Sample Product","uniqueKey":"data.line_items.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","example":"Sample Product","uniqueKey":"data.line_items.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.line_items.items.[INDEX].title","typeLabel":"string | null"},"quantity":{"oneOf":[{"type":"integer","example":2,"uniqueKey":"data.line_items.items.[INDEX].quantity.oneOf.0","typeLabel":"integer"},{"type":"null","example":2,"uniqueKey":"data.line_items.items.[INDEX].quantity.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.line_items.items.[INDEX].quantity","typeLabel":"integer | null"},"price":{"oneOf":[{"type":"string","description":"Unit price for the line, echoed back as sent.\n","example":45,"uniqueKey":"data.line_items.items.[INDEX].price.oneOf.0","typeLabel":"string"},{"type":"number","description":"Unit price for the line, echoed back as sent.\n","example":45,"uniqueKey":"data.line_items.items.[INDEX].price.oneOf.1","typeLabel":"number"},{"type":"null","description":"Unit price for the line, echoed back as sent.\n","example":45,"uniqueKey":"data.line_items.items.[INDEX].price.oneOf.2","typeLabel":"null"}],"uniqueKey":"data.line_items.items.[INDEX].price","typeLabel":"string | number | null"}},"uniqueKey":"data.line_items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.line_items","typeLabel":"object[]"},"billing_address":{"type":"object","description":"A billing or shipping address. Stored and echoed back verbatim.\nWhen a new contact is created, its name is taken from the address —\nshipping first, billing as fallback — using `first_name`/`last_name`,\nor a single `name` field split on whitespace.\n","additionalProperties":true,"properties":{"first_name":{"oneOf":[{"type":"string","example":"Jane","uniqueKey":"data.billing_address.first_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Jane","uniqueKey":"data.billing_address.first_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","example":"Shopper","uniqueKey":"data.billing_address.last_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Shopper","uniqueKey":"data.billing_address.last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.last_name","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Full name; used when `first_name`/`last_name` are absent.","example":"Jane Shopper","uniqueKey":"data.billing_address.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Full name; used when `first_name`/`last_name` are absent.","example":"Jane Shopper","uniqueKey":"data.billing_address.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.name","typeLabel":"string | null"},"address1":{"oneOf":[{"type":"string","example":"123 Main St","uniqueKey":"data.billing_address.address1.oneOf.0","typeLabel":"string"},{"type":"null","example":"123 Main St","uniqueKey":"data.billing_address.address1.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.address1","typeLabel":"string | null"},"address2":{"oneOf":[{"type":"string","example":"Apt 101","uniqueKey":"data.billing_address.address2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Apt 101","uniqueKey":"data.billing_address.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.address2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","example":"Boston","uniqueKey":"data.billing_address.city.oneOf.0","typeLabel":"string"},{"type":"null","example":"Boston","uniqueKey":"data.billing_address.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.city","typeLabel":"string | null"},"state_code":{"oneOf":[{"type":"string","example":"MA","uniqueKey":"data.billing_address.state_code.oneOf.0","typeLabel":"string"},{"type":"null","example":"MA","uniqueKey":"data.billing_address.state_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.state_code","typeLabel":"string | null"},"country_code":{"oneOf":[{"type":"string","example":"US","uniqueKey":"data.billing_address.country_code.oneOf.0","typeLabel":"string"},{"type":"null","example":"US","uniqueKey":"data.billing_address.country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.country_code","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","example":"02118","uniqueKey":"data.billing_address.postal_code.oneOf.0","typeLabel":"string"},{"type":"null","example":"02118","uniqueKey":"data.billing_address.postal_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.billing_address.postal_code","typeLabel":"string | null"}},"uniqueKey":"data.billing_address","typeLabel":"object"},"shipping_address":{"type":"object","description":"A billing or shipping address. Stored and echoed back verbatim.\nWhen a new contact is created, its name is taken from the address —\nshipping first, billing as fallback — using `first_name`/`last_name`,\nor a single `name` field split on whitespace.\n","additionalProperties":true,"properties":{"first_name":{"oneOf":[{"type":"string","example":"Jane","uniqueKey":"data.shipping_address.first_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Jane","uniqueKey":"data.shipping_address.first_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","example":"Shopper","uniqueKey":"data.shipping_address.last_name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Shopper","uniqueKey":"data.shipping_address.last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.last_name","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Full name; used when `first_name`/`last_name` are absent.","example":"Jane Shopper","uniqueKey":"data.shipping_address.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Full name; used when `first_name`/`last_name` are absent.","example":"Jane Shopper","uniqueKey":"data.shipping_address.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.name","typeLabel":"string | null"},"address1":{"oneOf":[{"type":"string","example":"123 Main St","uniqueKey":"data.shipping_address.address1.oneOf.0","typeLabel":"string"},{"type":"null","example":"123 Main St","uniqueKey":"data.shipping_address.address1.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.address1","typeLabel":"string | null"},"address2":{"oneOf":[{"type":"string","example":"Apt 101","uniqueKey":"data.shipping_address.address2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Apt 101","uniqueKey":"data.shipping_address.address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.address2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","example":"Boston","uniqueKey":"data.shipping_address.city.oneOf.0","typeLabel":"string"},{"type":"null","example":"Boston","uniqueKey":"data.shipping_address.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.city","typeLabel":"string | null"},"state_code":{"oneOf":[{"type":"string","example":"MA","uniqueKey":"data.shipping_address.state_code.oneOf.0","typeLabel":"string"},{"type":"null","example":"MA","uniqueKey":"data.shipping_address.state_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.state_code","typeLabel":"string | null"},"country_code":{"oneOf":[{"type":"string","example":"US","uniqueKey":"data.shipping_address.country_code.oneOf.0","typeLabel":"string"},{"type":"null","example":"US","uniqueKey":"data.shipping_address.country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.country_code","typeLabel":"string | null"},"postal_code":{"oneOf":[{"type":"string","example":"02118","uniqueKey":"data.shipping_address.postal_code.oneOf.0","typeLabel":"string"},{"type":"null","example":"02118","uniqueKey":"data.shipping_address.postal_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.shipping_address.postal_code","typeLabel":"string | null"}},"uniqueKey":"data.shipping_address","typeLabel":"object"},"accepts_email_marketing":{"type":"boolean","description":"The email marketing opt-in reported with the order, echoed back as sent. It records what\nthe order said, not the contact's consent now — read that from the contact's\n`email_consent`.\n","example":true,"uniqueKey":"data.accepts_email_marketing","typeLabel":"boolean"},"accepts_sms_marketing":{"type":"boolean","description":"The SMS marketing opt-in reported with the order, echoed back as sent. As with\n`accepts_email_marketing`, the contact's current consent lives on the contact\n(`sms_consent`), not here.\n","example":true,"uniqueKey":"data.accepts_sms_marketing","typeLabel":"boolean"},"integration":{"type":"object","description":"The Custom Integration the order is tied to. Present only when the order was attributed to an integration\n(via the `X-Privy-Integration-Token` header or auto-tie).\n","properties":{"store_name":{"type":"string","example":"My Store","uniqueKey":"data.integration.store_name","typeLabel":"string"},"store_url":{"type":"string","example":"https://mystore.example.com","uniqueKey":"data.integration.store_url","typeLabel":"string"}},"uniqueKey":"data.integration","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","example":"2026-06-01T12:00:05Z","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-06-01T12:00:05Z","uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"order_id":1001,"source":"api","email":"buyer@example.com","phone":"+12025550123","total_amount":"95.00","currency_code":"USD","placed_at":"2026-06-01T12:00:00Z","financial_status":"paid","fulfillment_status":"fulfilled","subtotal":90,"total_items":2,"line_items":[{"sku":"SKU-1","quantity":2,"price":45}],"created_at":"2026-06-01T12:00:05Z","updated_at":"2026-06-01T12:00:05Z"}},"examples":{"Example":{"title":"Example","value":{"data":{"order_id":1001,"source":"api","email":"buyer@example.com","phone":"+12025550123","total_amount":"95.00","currency_code":"USD","placed_at":"2026-06-01T12:00:00Z","financial_status":"paid","fulfillment_status":"fulfilled","subtotal":90,"total_items":2,"line_items":[{"sku":"SKU-1","quantity":2,"price":45}],"created_at":"2026-06-01T12:00:05Z","updated_at":"2026-06-01T12:00:05Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"dda1fb74-6c27-4672-97b2-9fc25254397b":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_client","invalid_scope","unauthorized","insufficient_scope","forbidden","paid_plan_required","api_access_required","segment_builder_required","not_found","no_connected_store","conflict","contacts_not_ready","validation_failed","idempotency_key_reused","rate_limited","store_unavailable","store_rate_limited","not_a_draft","design_changed","sms_missing","email_missing","ab_test_draft","idempotency_key_reused","template_unavailable","design_unavailable","render_failed"],"example":"validation_failed","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"One or more fields are invalid","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","example":"email","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"is required","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized","message":"Bearer token is missing or invalid"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"Bearer token is missing or invalid"}}}},"exampleType":"examples"}},"exampleType":"examples"},"cf79f309-285c-4c33-8414-59b5eb5552d9":{"description":"`insufficient_scope` when the token lacks the required scope for this endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_client","invalid_scope","unauthorized","insufficient_scope","forbidden","paid_plan_required","api_access_required","segment_builder_required","not_found","no_connected_store","conflict","contacts_not_ready","validation_failed","idempotency_key_reused","rate_limited","store_unavailable","store_rate_limited","not_a_draft","design_changed","sms_missing","email_missing","ab_test_draft","idempotency_key_reused","template_unavailable","design_unavailable","render_failed"],"example":"validation_failed","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"One or more fields are invalid","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","example":"email","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"is required","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"insufficient_scope","message":"Token does not have the required scope"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"insufficient_scope","message":"Token does not have the required scope"}}}},"exampleType":"examples"}},"exampleType":"examples"},"843eff03-86c3-4e58-bc99-4ba5d6121b86":{"description":"The requested resource does not exist or does not belong to your account.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_client","invalid_scope","unauthorized","insufficient_scope","forbidden","paid_plan_required","api_access_required","segment_builder_required","not_found","no_connected_store","conflict","contacts_not_ready","validation_failed","idempotency_key_reused","rate_limited","store_unavailable","store_rate_limited","not_a_draft","design_changed","sms_missing","email_missing","ab_test_draft","idempotency_key_reused","template_unavailable","design_unavailable","render_failed"],"example":"validation_failed","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"One or more fields are invalid","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","example":"email","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"is required","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"not_found","message":"Not found"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_found","message":"Not found"}}}},"exampleType":"examples"}},"exampleType":"examples"},"18cea654-dfeb-4e3f-a8bc-5a144b19c647":{"description":"Rate limit exceeded. Retry after the specified time.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"},"example":42},"X-RateLimit-Limit-Minute":{"description":"Maximum requests allowed per minute.","schema":{"type":"integer"},"example":60},"X-RateLimit-Remaining-Minute":{"description":"Requests remaining in the current minute window.","schema":{"type":"integer"},"example":0},"X-RateLimit-Reset-Minute":{"description":"Unix timestamp when the minute window resets.","schema":{"type":"integer"},"example":1711929600},"X-RateLimit-Limit-Day":{"description":"Maximum requests allowed per day.","schema":{"type":"integer"},"example":10000},"X-RateLimit-Remaining-Day":{"description":"Requests remaining in the current day window.","schema":{"type":"integer"},"example":9500},"X-RateLimit-Reset-Day":{"description":"Unix timestamp when the day window resets.","schema":{"type":"integer"},"example":1712016000}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_client","invalid_scope","unauthorized","insufficient_scope","forbidden","paid_plan_required","api_access_required","segment_builder_required","not_found","no_connected_store","conflict","contacts_not_ready","validation_failed","idempotency_key_reused","rate_limited","store_unavailable","store_rate_limited","not_a_draft","design_changed","sms_missing","email_missing","ab_test_draft","idempotency_key_reused","template_unavailable","design_unavailable","render_failed"],"example":"validation_failed","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"One or more fields are invalid","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","example":"email","uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"is required","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limited","message":"Rate limit exceeded"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"Rate limit exceeded"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"339e6a38-b368-4f3b-a2fa-aa789ad2e277":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API token or OAuth access token","description":"Send either an API token or an OAuth access token as\n`Authorization: Bearer \u003ctoken>`. See the Authentication page for details.\n","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"97f63e03-f020-41b7-a5b9-e312bbfed47d":{"url":"https://api.privy.com/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API token or OAuth access token","description":"Send either an API token or an OAuth access token as\n`Authorization: Bearer \u003ctoken>`. See the Authentication page for details.\n","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send either an API token or an OAuth access token as\n`Authorization: Bearer \u003ctoken>`. See the Authentication page for details.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi/privy-api.yaml"},"subdomain":"privy","siteName":"Privy Knowledge Base","title":"Get an order - Privy Knowledge Base","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T23:08:30.155Z","originalFileLocation":"docs/api-reference/get-order.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a single order by its order id — the identifier assigned by the order\u0026#x27;s source (your store platform, or the order_id you sent to POST /v1/orders/placed). Order ids are unique per source. In the rare case two sources share an id, the most recently created order is returned. A /v1/orders row already carries the whole order, so this is for an id that came from somewhere else rather than a follow-up read. Required scope: orders_read\">\u003cmeta data-mint-head name=\"application-name\" content=\"Privy Knowledge Base\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get an order - Privy Knowledge Base\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a single order by its order id — the identifier assigned by the order\u0026#x27;s source (your store platform, or the order_id you sent to POST /v1/orders/placed). Order ids are unique per source. In the rare case two sources share an id, the most recently created order is returned. A /v1/orders row already carries the whole order, so this is for an id that came from somewhere else rather than a follow-up read. Required scope: orders_read\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Privy Knowledge Base\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.privy.com/docs/api-reference/get-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://privy.mintlify.site/_mintlify/api/og/v2?division=Orders\u0026amp;title=Get+an+order\u0026amp;description=Retrieve+a+single+order+by+its+order+id+%E2%80%94+the+identifier+assigned+by+the+order%27s+source%0A%28your+store+platform%2C+or+the+%60order_id%60+you+sent+to+%60POST+%2Fv1%2Forders%2Fpla\u0026amp;theme=a5dbdd3119e247d04186b21c\u0026amp;signature=093d0f63c2209b75cff926580b6ce9ab5dcdededa9dc4cd1e76910bda5ae9aed\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get an order - Privy Knowledge Base\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a single order by its order id — the identifier assigned by the order\u0026#x27;s source (your store platform, or the order_id you sent to POST /v1/orders/placed). Order ids are unique per source. In the rare case two sources share an id, the most recently created order is returned. A /v1/orders row already carries the whole order, so this is for an id that came from somewhere else rather than a follow-up read. Required scope: orders_read\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://privy.mintlify.site/_mintlify/api/og/v2?division=Orders\u0026amp;title=Get+an+order\u0026amp;description=Retrieve+a+single+order+by+its+order+id+%E2%80%94+the+identifier+assigned+by+the+order%27s+source%0A%28your+store+platform%2C+or+the+%60order_id%60+you+sent+to+%60POST+%2Fv1%2Forders%2Fpla\u0026amp;theme=a5dbdd3119e247d04186b21c\u0026amp;signature=093d0f63c2209b75cff926580b6ce9ab5dcdededa9dc4cd1e76910bda5ae9aed\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/privy/fvbglk3MPcKWjtyG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Privy Knowledge Base\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#254E5A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.privy.com/docs/api-reference/get-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/get-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.privy.com/#organization\",\"name\":\"Privy Knowledge Base\",\"url\":\"https://help.privy.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/privy/fGrkZt933tBjY_zl/logo/light.svg?fit=max\u0026auto=format\u0026n=fGrkZt933tBjY_zl\u0026q=85\u0026s=36a01db426b7c94fac423778765cd517\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.privy.com#website\",\"name\":\"Privy Knowledge Base\",\"url\":\"https://help.privy.com\",\"publisher\":{\"@id\":\"https://help.privy.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.privy.com/docs/api-reference/get-order#webpage\",\"url\":\"https://help.privy.com/docs/api-reference/get-order\",\"name\":\"Get an order\",\"description\":\"Retrieve a single order by its order id — the identifier assigned by the order's source (your store platform, or the order_id you sent to POST /v1/orders/placed). Order ids are unique per source. In the rare case two sources share an id, the most recently created order is returned. A /v1/orders row already carries the whole order, so this is for an id that came from somewhere else rather than a follow-up read. Required scope: orders_read\",\"dateModified\":\"2026-10-22T23:08:30.155Z\",\"isPartOf\":{\"@id\":\"https://help.privy.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.privy.com/docs/api-reference/get-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.privy.com/docs/api-reference/get-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Orders\",\"item\":\"https://help.privy.com/docs/api-reference/order-placed\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get an order\",\"item\":\"https://help.privy.com/docs/api-reference/get-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.privy.com/docs/api-reference/get-order#apireference\",\"headline\":\"Get an order\",\"name\":\"Get an order\",\"description\":\"Retrieve a single order by its order id — the identifier assigned by the order's source (your store platform, or the order_id you sent to POST /v1/orders/placed). Order ids are unique per source. In the rare case two sources share an id, the most recently created order is returned. A /v1/orders row already carries the whole order, so this is for an id that came from somewhere else rather than a follow-up read. Required scope: orders_read\",\"url\":\"https://help.privy.com/docs/api-reference/get-order\",\"mainEntityOfPage\":{\"@id\":\"https://help.privy.com/docs/api-reference/get-order#webpage\"},\"dateModified\":\"2026-10-22T23:08:30.155Z\",\"publisher\":{\"@id\":\"https://help.privy.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.privy.com#website\"}}]}\u003c/script>","agentPointerHref":"/docs/api-reference/get-order.md","siteName":"Privy Knowledge Base","nav":{"global":null,"tabs":[{"tab":"Learn","icon":"house","pages":[{"title":"Learn","href":"/docs/learn/home"}]},{"tab":"Developer","icon":"square-terminal","groups":[{"group":"API Reference","pages":[{"title":"API Overview","sidebarTitle":"Overview","icon":"book-open","href":"/docs/api-reference/overview"},{"title":"Authentication","sidebarTitle":"Authentication","icon":"lock","href":"/docs/api-reference/authentication"},{"title":"API Tokens","sidebarTitle":"API Tokens","icon":"key","href":"/docs/api-reference/api-tokens"},{"title":"Rate Limits","sidebarTitle":"Rate Limits","icon":"gauge","href":"/docs/api-reference/rate-limits"},{"title":"Errors","sidebarTitle":"Errors","icon":"triangle-exclamation","href":"/docs/api-reference/errors"},{"title":"API Changelog","sidebarTitle":"Changelog","icon":"clock-rotate-left","href":"/docs/api-reference/changelog"}]},{"group":"Account","pages":[{"title":"Get account","openapi":"openapi/privy-api.yaml GET /account","href":"/docs/api-reference/get-account"},{"title":"Get account setup","openapi":"openapi/privy-api.yaml GET /account/setup","href":"/docs/api-reference/get-account-setup"}]},{"group":"Contacts","pages":[{"title":"List contacts","openapi":"openapi/privy-api.yaml GET /contacts","href":"/docs/api-reference/list-contacts"},{"title":"Get a contact","openapi":"openapi/privy-api.yaml GET /contacts/{id}","href":"/docs/api-reference/get-contact"},{"title":"Create a contact","openapi":"openapi/privy-api.yaml POST /contacts","href":"/docs/api-reference/create-contact"},{"title":"Update a contact","openapi":"openapi/privy-api.yaml PATCH /contacts/{id}","href":"/docs/api-reference/update-contact"},{"title":"Delete a contact","openapi":"openapi/privy-api.yaml DELETE /contacts/{id}","href":"/docs/api-reference/delete-contact"},{"title":"List a contact's activity","openapi":"openapi/privy-api.yaml GET /contacts/{id}/events","href":"/docs/api-reference/list-contact-activity"}]},{"group":"Imports","pages":[{"title":"List contact imports","openapi":"openapi/privy-api.yaml GET /imports","href":"/docs/api-reference/list-imports"},{"title":"Get a contact import","openapi":"openapi/privy-api.yaml GET /imports/{id}","href":"/docs/api-reference/get-import"}]},{"group":"Tags","pages":[{"title":"List tags","openapi":"openapi/privy-api.yaml GET /tags","href":"/docs/api-reference/list-tags"},{"title":"Get a tag","openapi":"openapi/privy-api.yaml GET /tags/{id}","href":"/docs/api-reference/get-tag"}]},{"group":"Campaigns","pages":[{"title":"List campaigns","openapi":"openapi/privy-api.yaml GET /campaigns","href":"/docs/api-reference/list-campaigns"},{"title":"Get a campaign","openapi":"openapi/privy-api.yaml GET /campaigns/{id}","href":"/docs/api-reference/get-campaign"}]},{"group":"Displays","pages":[{"title":"List displays","openapi":"openapi/privy-api.yaml GET /displays","href":"/docs/api-reference/list-displays"},{"title":"Get a display","openapi":"openapi/privy-api.yaml GET /displays/{id}","href":"/docs/api-reference/get-display"}]},{"group":"Coupons","pages":[{"title":"List coupons","openapi":"openapi/privy-api.yaml GET /coupons","href":"/docs/api-reference/list-coupons"},{"title":"Get a coupon","openapi":"openapi/privy-api.yaml GET /coupons/{id}","href":"/docs/api-reference/get-coupon"},{"title":"Check a coupon code","openapi":"openapi/privy-api.yaml GET /coupons/{id}/codes/{code}","href":"/docs/api-reference/check-coupon-code"}]},{"group":"Reports","pages":[{"title":"Get business report summary","openapi":"openapi/privy-api.yaml GET /reports/summary","href":"/docs/api-reference/get-report-summary"},{"title":"List campaign performance","openapi":"openapi/privy-api.yaml GET /reports/campaigns","href":"/docs/api-reference/list-campaign-performance"},{"title":"Get campaign performance","openapi":"openapi/privy-api.yaml GET /reports/campaigns/{campaign_id}","href":"/docs/api-reference/get-campaign-performance"},{"title":"List flow performance","openapi":"openapi/privy-api.yaml GET /reports/flows","href":"/docs/api-reference/list-flow-performance"},{"title":"Get flow performance","openapi":"openapi/privy-api.yaml GET /reports/flows/{flow_id}","href":"/docs/api-reference/get-flow-performance"},{"title":"List display performance","openapi":"openapi/privy-api.yaml GET /reports/displays","href":"/docs/api-reference/list-display-performance"},{"title":"Get display performance","openapi":"openapi/privy-api.yaml GET /reports/displays/{display_id}","href":"/docs/api-reference/get-display-performance"},{"title":"List top products","openapi":"openapi/privy-api.yaml GET /reports/top_products","href":"/docs/api-reference/list-top-products"}]},{"group":"Flows","pages":[{"title":"List flows","openapi":"openapi/privy-api.yaml GET /flows","href":"/docs/api-reference/list-flows"},{"title":"Get a flow","openapi":"openapi/privy-api.yaml GET /flows/{id}","href":"/docs/api-reference/get-flow"}]},{"group":"Segments","pages":[{"title":"List segments","openapi":"openapi/privy-api.yaml GET /segments","href":"/docs/api-reference/list-segments"},{"title":"Get a segment","openapi":"openapi/privy-api.yaml GET /segments/{id}","href":"/docs/api-reference/get-segment"},{"title":"List a segment's contacts","openapi":"openapi/privy-api.yaml GET /segments/{id}/contacts","href":"/docs/api-reference/list-segment-contacts"}]},{"group":"Orders","pages":[{"title":"Order placed","openapi":"openapi/privy-api.yaml POST /orders/placed","href":"/docs/api-reference/order-placed"},{"title":"List orders","openapi":"openapi/privy-api.yaml GET /orders","description":"Retrieve a paginated list of your orders across every source (Shopify,\nBigCommerce, Weebly, Wix, and orders reported via this API), most recently created first.\n\nOrders imported before Privy began denormalizing order timestamps may be excluded when a date filter is applied.\n\nRows carry the full order shape, so no per-order follow-up is needed, and\nthe only filters are the placed-date ones — none by contact, email, or\nstatus.\n\n**Required scope:** `orders_read`\n","href":"/docs/api-reference/list-orders"},{"title":"Get an order","openapi":"openapi/privy-api.yaml GET /orders/{order_id}","href":"/docs/api-reference/get-order"}]},{"group":"Products","pages":[{"title":"List products","openapi":"openapi/privy-api.yaml GET /products","description":"Retrieve the product catalog of your connected store (Shopify or BigCommerce), proxied live from the store's API.\n\nUnlike the other list endpoints, products use **cursor pagination**:\npass the `next_cursor` from each response as `?cursor=` to fetch the next page,\nkeeping the same filters. There are no `page` numbers.\n\nRequires a connected Shopify or BigCommerce store — without one, this endpoint returns `404 no_connected_store`.\n\nThe response shape is the same on both platforms; fields BigCommerce does not\nsupply (`product_type`, `vendor`, `url`) are `null`. Large `per_page` values can\nbe slow on BigCommerce stores whose products carry many variants — reduce\n`per_page` if requests return `502 store_unavailable`.\n\nA live read of the store's own catalog — nothing here is Privy data, and no\nendpoint reports sales or performance per product. `/v1/products/{id}` adds\ndescription, tags, options, and images.\n\n**Required scope:** `products_read`\n","href":"/docs/api-reference/list-products"},{"title":"Get a product","openapi":"openapi/privy-api.yaml GET /products/{id}","href":"/docs/api-reference/get-product"},{"title":"List product collections","openapi":"openapi/privy-api.yaml GET /product_collections","href":"/docs/api-reference/list-product-collections"},{"title":"Get a product collection","openapi":"openapi/privy-api.yaml GET /product_collections/{id}","href":"/docs/api-reference/get-product-collection"},{"title":"List a collection's products","openapi":"openapi/privy-api.yaml GET /product_collections/{id}/products","href":"/docs/api-reference/list-collection-products"},{"title":"List a product's collections","openapi":"openapi/privy-api.yaml GET /products/{id}/collections","href":"/docs/api-reference/list-collections-for-product"}]},{"group":"Events","pages":[{"title":"Ingest an event","openapi":"openapi/privy-api.yaml POST /events","href":"/docs/api-reference/ingest-event"},{"title":"Send cart events from your storefront","sidebarTitle":"Browser events","href":"/docs/api-reference/browser-events"}]}]}]},"basePath":"","title":"Get an order - Privy Knowledge Base","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}