Place one order per marketplace sale, for one product: tickets to an event, or seats on one session of an experience. Gomry issues them inside the request and answers with them.
external_ref makes it safe to retry. It is your order id. Send the same external_ref with the same lines and you get the same order back, never a second one. A timeout or a dropped connection is safe to retry as is.
string
required
Your order id. 1 to 128 letters, digits, ., _, : or -. Reusing it with different lines is refused with order_mismatch.
Experiences only, and required there: the session’s start.utc, from the product’s sessions. An event has one session and needs none.
string
When you held the seats first. The order must match the hold’s session and lines.
array
required
One to 20 lines.
Show Line
string
required
From the product’s offers.
integer
required
1 to 50, within the offer’s min_per_order and max_per_order.
object
required
Show Buyer
string
required
The buyer’s name, or the marketplace’s name when it keeps the buyer’s.
string
When you have it, Gomry emails the buyer their tickets. Leave it out when the marketplace keeps it: the buyer can still claim their tickets from the accept link. An experience needs an email here or in transfer_to: Gomry sends the booking confirmation.
string
Optional.
object
The person the marketplace sold the tickets to, when you know them. Gomry hands the tickets over like a mobile transfer: it emails them the order’s accept link and fills the accept page in for them. The tickets stay in the buyer name until they accept. Send it on every post of the order; the first one Gomry receives is kept. See Delivery.
Nothing is issued and nothing is owed. The common ones:
code
Do this
sold_out
Cancel the sale on the marketplace. Re-read the product.
not_listed
The offer stopped selling (reason says why). Take it down and cancel the sale.
credit_limit_reached
Pay your statement. The same order succeeds once you are under your limit.
order_in_progress
The first attempt is still issuing. Retry in a few seconds with the same external_ref.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gomry API","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#FFFFFF"},"logo":{"light":"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/images/logo-light.png?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=f219d76acf24de2d111ed934cfcb6606","dark":"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/images/logo-dark.png?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=72b9aee24c65cf76a8c0f17f88337855"},"favicon":"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/favicon.ico?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=a81575b3950229a1b14b4260130ce0bf","api":{"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://www.gomry.com/api/v1"}},"navbar":{"links":[{"href":"https://www.gomry.com","label":"Dashboard"}]},"footer":{"socials":{"website":"https://gomry.com","linkedin":"https://www.linkedin.com/company/gomry"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gomry","hasAudioNarration":false,"actualSubdomain":"gomry","customDomains":["docs.gomry.com"],"gitSource":{"type":"github","owner":"gomryhq","repo":"gomry","deployBranch":"master","contentDirectory":"docs/api-reference","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b00851f06faa1652edc0f9b","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":107},{"language":"default","tag":"Platform API","count":66},{"language":"default","tag":"Commerce API","count":16},{"language":"default","tag":"Distribution API","count":13},{"language":"default","tag":"Retail Vendor API","count":12},{"language":"default","tag":"Getting Started","count":8},{"language":"default","tag":"Checkout Sessions","count":7},{"language":"default","tag":"Contacts","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Overview","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"distribution-api/create-order","slug":"/distribution-api/create-order","pageMetadata":{"title":"Place an order","api":"POST https://www.gomry.com/api/v1/distribution/orders","authMethod":"bearer","playground":"none","description":"One order per marketplace sale. Gomry issues the tickets inside the request.","href":"/distribution-api/create-order"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"One order per marketplace sale. Gomry issues the tickets inside the request.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Place one order per marketplace sale, for one `,_jsx(_components.a,{href:`/distribution-api/list-products`,children:`product`}),`: tickets to an event, or seats on one session of an experience. Gomry issues them inside the request and answers with them.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`external_ref`}),` makes it safe to retry.`]}),` It is your order id. Send the same `,_jsx(_components.code,{children:`external_ref`}),` with the same lines and you get the same order back, never a second one. A timeout or a dropped connection is safe to retry as is.`]})}),`\n`,_jsx(ParamField,{body:`external_ref`,type:`string`,required:true,id:`param-external-ref`,children:_jsxs(_components.p,{children:[`Your order id. 1 to 128 letters, digits, `,_jsx(_components.code,{children:`.`}),`, `,_jsx(_components.code,{children:`_`}),`, `,_jsx(_components.code,{children:`:`}),` or `,_jsx(_components.code,{children:`-`}),`. Reusing it with different lines is refused with `,_jsx(_components.code,{children:`order_mismatch`}),`.`]})}),`\n`,_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id`,children:_jsxs(_components.p,{children:[`From `,_jsx(_components.a,{href:`/distribution-api/list-products`,children:`products`}),`: `,_jsx(_components.code,{children:`evt_…`}),` or `,_jsx(_components.code,{children:`exp_…`}),`.`]})}),`\n`,_jsx(ParamField,{body:`start`,type:`string`,id:`param-start`,children:_jsxs(_components.p,{children:[`Experiences only, and required there: the session’s `,_jsx(_components.code,{children:`start.utc`}),`, from the product’s sessions. An event has one session and needs none.`]})}),`\n`,_jsx(ParamField,{body:`hold_id`,type:`string`,id:`param-hold-id`,children:_jsxs(_components.p,{children:[`When you `,_jsx(_components.a,{href:`/distribution-api/create-hold`,children:`held the seats`}),` first. The order must match the hold’s session and lines.`]})}),`\n`,_jsxs(ParamField,{body:`lines`,type:`array`,required:true,id:`param-lines`,children:[_jsx(_components.p,{children:`One to 20 lines.`}),_jsxs(Expandable,{title:`Line`,children:[_jsxs(ParamField,{body:`offer_id`,type:`string`,required:true,id:`param-offer-id`,children:[`From the product’s `,_jsx(_components.code,{children:`offers`}),`.`]}),_jsxs(ParamField,{body:`quantity`,type:`integer`,required:true,id:`param-quantity`,children:[`1 to 50, within the offer’s `,_jsx(_components.code,{children:`min_per_order`}),` and `,_jsx(_components.code,{children:`max_per_order`}),`.`]})]})]}),`\n`,_jsx(ParamField,{body:`buyer`,type:`object`,required:true,id:`param-buyer`,children:_jsxs(Expandable,{title:`Buyer`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:`The buyer’s name, or the marketplace’s name when it keeps the buyer’s.`}),_jsxs(ParamField,{body:`email`,type:`string`,id:`param-email`,children:[`When you have it, Gomry emails the buyer their tickets. Leave it out when the marketplace keeps it: the buyer can still claim their tickets from the `,_jsx(_components.a,{href:`/distribution-api/delivery`,children:`accept link`}),`. An experience needs an email here or in `,_jsx(_components.code,{children:`transfer_to`}),`: Gomry sends the booking confirmation.`]}),_jsx(ParamField,{body:`phone`,type:`string`,id:`param-phone`,children:`Optional.`})]})}),`\n`,_jsxs(ParamField,{body:`transfer_to`,type:`object`,id:`param-transfer-to`,children:[_jsxs(_components.p,{children:[`The person the marketplace sold the tickets to, when you know them. Gomry hands the tickets over like a mobile transfer: it emails them the order’s accept link and fills the accept page in for them. The tickets stay in the `,_jsx(_components.code,{children:`buyer`}),` name until they accept. Send it on every post of the order; the first one Gomry receives is kept. See `,_jsx(_components.a,{href:`/distribution-api/delivery`,children:`Delivery`}),`.`]}),_jsxs(Expandable,{title:`Recipient`,children:[_jsx(ParamField,{body:`email`,type:`string`,required:true,id:`param-email-1`,children:`Where Gomry sends the accept link.`}),_jsx(ParamField,{body:`first_name`,type:`string`,id:`param-first-name`,children:`Optional.`}),_jsx(ParamField,{body:`last_name`,type:`string`,id:`param-last-name`,children:`Optional.`})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST https://www.gomry.com/api/v1/distribution/orders \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer gdk_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"external_ref\": \"mkt-1834221\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"product_id\": \"evt_4wfgqZSyaLdroutDkeZ7\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"lines\": [{ \"offer_id\": \"hnTv4341P391VfkiH5XT\", \"quantity\": 2 }],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"buyer\": { \"name\": \"StubHub\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"transfer_to\": { \"first_name\": \"Grace\", \"last_name\": \"Hopper\", \"email\": \"grace@example.com\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Seats on an experience session name the session’s start:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"external_ref\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gyg:GYG123:res-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"product_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"exp_1y9Gr0O6FGmS38BSQcJf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"start\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-12-01T10:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"hold_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"acme__cart-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lines\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"offer_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tc-adult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"quantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"buyer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ada Lovelace\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ada@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Answers `,_jsx(_components.code,{children:`201`}),` with the `,_jsx(_components.a,{href:`/distribution-api/get-order#the-order`,children:`order`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-an-order-is-refused`,children:`When an order is refused`}),`\n`,_jsx(_components.p,{children:`Nothing is issued and nothing is owed. The common ones:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`Do this`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sold_out`})}),_jsx(_components.td,{children:`Cancel the sale on the marketplace. Re-read the product.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`not_listed`})}),_jsxs(_components.td,{children:[`The offer stopped selling (`,_jsx(_components.code,{children:`reason`}),` says why). Take it down and cancel the sale.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`credit_limit_reached`})}),_jsxs(_components.td,{children:[`Pay your `,_jsx(_components.a,{href:`/distribution-api/get-statement`,children:`statement`}),`. The same order succeeds once you are under your limit.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`order_in_progress`})}),_jsxs(_components.td,{children:[`The first attempt is still issuing. Retry in a few seconds with the same `,_jsx(_components.code,{children:`external_ref`}),`.`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Place an order","api":"POST https://www.gomry.com/api/v1/distribution/orders","authMethod":"bearer","playground":"none","description":"One order per marketplace sale. Gomry issues the tickets inside the request.","href":"/distribution-api/create-order"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"When an order is refused","slug":"when-an-order-is-refused","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Place an order","path":"/api/v1/distribution/orders","servers":[{"url":"https://www.gomry.com"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"external_ref":[{"type":"string","description":"Your order id. 1 to 128 letters, digits, `.` , `_` , `:` or `-` . Reusing it with different lines is refused with `order_mismatch` .","required":true}],"product_id":[{"type":"string","description":"From products : `evt_…` or `exp_…` .","required":true}],"start":[{"type":"string","description":"Experiences only, and required there: the session’s `start.utc` , from the product’s sessions. An event has one session and needs none."}],"hold_id":[{"type":"string","description":"When you held the seats first. The order must match the hold’s session and lines."}],"lines":[{"type":"array","items":[{"type":"object","properties":{"offer_id":[{"type":"string","description":"From the product’s `offers` .","required":true}],"quantity":[{"type":"integer","description":"1 to 50, within the offer’s `min_per_order` and `max_per_order` .","required":true}]}}],"description":"One to 20 lines.","required":true}],"buyer":[{"type":"object","properties":{"name":[{"type":"string","description":"The buyer’s name, or the marketplace’s name when it keeps the buyer’s.","required":true}],"email":[{"type":"string","description":"When you have it, Gomry emails the buyer their tickets. Leave it out when the marketplace keeps it: the buyer can still claim their tickets from the accept link . An experience needs an email here or in `transfer_to` : Gomry sends the booking confirmation."}],"phone":[{"type":"string","description":"Optional."}]},"required":true}],"transfer_to":[{"type":"object","properties":{"email":[{"type":"string","description":"Where Gomry sends the accept link.","required":true}],"first_name":[{"type":"string","description":"Optional."}],"last_name":[{"type":"string","description":"Optional."}]},"description":"The person the marketplace sold the tickets to, when you know them. Gomry hands the tickets over like a mobile transfer: it emails them the order’s accept link and fills the accept page in for them. The tickets stay in the `buyer` name until they accept. Send it on every post of the order; the first one Gomry receives is kept. See Delivery ."}]}}],"examples":{"example":{"value":{"external_ref":"\u003cstring>","product_id":"\u003cstring>","start":"\u003cstring>","hold_id":"\u003cstring>","lines":[{"offer_id":"\u003cstring>","quantity":123}],"buyer":{"name":"\u003cstring>","email":"\u003cstring>","phone":"\u003cstring>"},"transfer_to":{"email":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>"}}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"gomry","siteName":"Gomry API","title":"Place an order - Gomry API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T17:32:24.689Z","originalFileLocation":"distribution-api/create-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=\"One order per marketplace sale. Gomry issues the tickets inside the request.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gomry API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_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/gomry/bqp84X4_mSd9jp4X/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gomry/bqp84X4_mSd9jp4X/_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/gomry/bqp84X4_mSd9jp4X/_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/gomry/bqp84X4_mSd9jp4X/_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/gomry/bqp84X4_mSd9jp4X/_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/gomry/bqp84X4_mSd9jp4X/_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/gomry/bqp84X4_mSd9jp4X/_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/gomry/bqp84X4_mSd9jp4X/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Place an order - Gomry API\">\u003cmeta data-mint-head property=\"og:description\" content=\"One order per marketplace sale. Gomry issues the tickets inside the request.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gomry API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gomry.com/distribution-api/create-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gomry.mintlify.site/_mintlify/api/og/v2?division=Orders\u0026amp;title=Place+an+order\u0026amp;description=One+order+per+marketplace+sale.+Gomry+issues+the+tickets+inside+the+request.\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=f06b669ec5048044eccbf5ec9f73544cc3cace04b66ba8f4bccde79235f1b51f\">\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=\"Place an order - Gomry API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One order per marketplace sale. Gomry issues the tickets inside the request.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gomry.mintlify.site/_mintlify/api/og/v2?division=Orders\u0026amp;title=Place+an+order\u0026amp;description=One+order+per+marketplace+sale.+Gomry+issues+the+tickets+inside+the+request.\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=f06b669ec5048044eccbf5ec9f73544cc3cace04b66ba8f4bccde79235f1b51f\">\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/gomry/bqp84X4_mSd9jp4X/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gomry API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gomry.com/distribution-api/create-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/distribution-api/create-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gomry.com/#organization\",\"name\":\"Gomry API\",\"url\":\"https://docs.gomry.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gomry/jDJp3Wqzn5wDGgQC/images/logo-light.png?fit=max\u0026auto=format\u0026n=jDJp3Wqzn5wDGgQC\u0026q=85\u0026s=f219d76acf24de2d111ed934cfcb6606\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gomry.com#website\",\"name\":\"Gomry API\",\"url\":\"https://docs.gomry.com\",\"publisher\":{\"@id\":\"https://docs.gomry.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gomry.com/distribution-api/create-order#webpage\",\"url\":\"https://docs.gomry.com/distribution-api/create-order\",\"name\":\"Place an order\",\"description\":\"One order per marketplace sale. Gomry issues the tickets inside the request.\",\"dateModified\":\"2026-11-19T17:32:24.689Z\",\"isPartOf\":{\"@id\":\"https://docs.gomry.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomry.com/distribution-api/create-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomry.com/distribution-api/create-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Gomry API\",\"item\":\"https://docs.gomry.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Place an order\",\"item\":\"https://docs.gomry.com/distribution-api/create-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomry.com/distribution-api/create-order#apireference\",\"headline\":\"Place an order\",\"name\":\"Place an order\",\"description\":\"One order per marketplace sale. Gomry issues the tickets inside the request.\",\"url\":\"https://docs.gomry.com/distribution-api/create-order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomry.com/distribution-api/create-order#webpage\"},\"dateModified\":\"2026-11-19T17:32:24.689Z\",\"publisher\":{\"@id\":\"https://docs.gomry.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gomry.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gomry API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Gomry API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/distribution-api/create-order.md","siteName":"Gomry API","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Platform API","pages":[{"title":"Platform API","href":"/introduction"}]},{"tab":"Commerce API","pages":[{"title":"Commerce API","href":"/commerce/introduction"}]},{"tab":"Retail Vendor API","pages":[{"title":"Retail Vendor API","href":"/vendor-api/introduction"}]},{"tab":"Distribution API","groups":[{"group":"Overview","pages":[{"title":"Distribution API","href":"/distribution-api/introduction"},{"title":"Delivery","href":"/distribution-api/delivery"}]},{"group":"Products","pages":[{"title":"List products","api":"GET https://www.gomry.com/api/v1/distribution/products","playground":"none","href":"/distribution-api/list-products"},{"title":"Get a product's sessions","api":"GET https://www.gomry.com/api/v1/distribution/products/{product_id}/sessions","playground":"none","href":"/distribution-api/product-sessions"},{"title":"List changed products","api":"GET https://www.gomry.com/api/v1/distribution/products/changes","playground":"none","href":"/distribution-api/product-changes"}]},{"group":"Holds","pages":[{"title":"Hold seats","api":"POST https://www.gomry.com/api/v1/distribution/holds","playground":"none","href":"/distribution-api/create-hold"},{"title":"Release a hold","api":"POST https://www.gomry.com/api/v1/distribution/holds/{hold_id}/release","playground":"none","description":"Give held seats back before the hold expires.","href":"/distribution-api/release-hold"}]},{"group":"Orders","pages":[{"title":"Place an order","api":"POST https://www.gomry.com/api/v1/distribution/orders","playground":"none","href":"/distribution-api/create-order"},{"title":"Get an order","api":"GET https://www.gomry.com/api/v1/distribution/orders/{id}","playground":"none","description":"Read one order back: its tickets, codes and accept link.","href":"/distribution-api/get-order"},{"title":"Cancel an order","api":"POST https://www.gomry.com/api/v1/distribution/orders/{id}/cancel","playground":"none","href":"/distribution-api/cancel-order"},{"title":"List orders Gomry cancelled","api":"GET https://www.gomry.com/api/v1/distribution/orders","playground":"none","href":"/distribution-api/list-cancelled-orders"}]},{"group":"Billing","pages":[{"title":"Get your statement","api":"GET https://www.gomry.com/api/v1/distribution/statement","playground":"none","href":"/distribution-api/get-statement"}]},{"group":"Reporting","pages":[{"title":"Report your listings","api":"PUT https://www.gomry.com/api/v1/distribution/marketplace","playground":"none","href":"/distribution-api/report-marketplace"}]}]}]},{"anchor":"Support","icon":"envelope","href":"mailto:support@gomry.com"}]},"basePath":"","title":"Place an order - Gomry API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}