Returns every listing currently for sale on one event. Retail calls this while a buyer’s page is loading, filters the results by its own rules, and shows what passes. Nothing here is stored.
Answer within 4.5 seconds, and never retry internally. The buyer’s page has a hard budget. A slow success is worse than a fast failure, because by the time it arrives the page has already rendered the event as unavailable.
Listings are quotes, not inventory. A vendorListingId may change between calls, and a listing that has been bought should disappear from the response, not report quantity 0.
Return { "listings": [] } when the event genuinely has nothing for sale. If you could not ask your system, return an error instead: an empty list shows a live event as sold out, and nobody investigates a sold-out event.
array
required
Show Listing object
string
required
Your id for this listing. Retail sends it back on quote and order.
string
required
The event this listing belongs to.
string
required
How the ticket reaches the buyer. One of:
Value
Meaning
eticket
A printable or scannable ticket with a barcode Retail can retrieve.
mobile_transfer
Transferred into the buyer’s own account with the box office, addressed to their email.
flash_seats
An account-based mobile ticket, also delivered to the buyer’s email.
physical
A paper ticket couriered to an address.
local_pickup
Collected at the venue or another location.
paperless
Entry by card or ID, no ticket to hand over.
unknown
You cannot tell. Never sold.
Classify from your system’s delivery-method field, not from a yes/no “e-ticket” flag. A flag like that is often true for mobile transfers too, and overstates e-ticket supply several times over.
string
default:"ticket"
What the listing is: ticket (admission), parking, or other. A parking pass is delivered exactly like an e-ticket, so nothing else in the payload tells it apart from a seat. Always send this. It defaults to ticket, and an add-on without it will be sold as admission.
string
Section name as printed on the ticket.
string
Row.
number
required
Price per ticket Gomry Retail pays you.
number
required
Your suggested retail price per ticket. A reference for pricing only: Gomry sets its own price from wholesalePrice.
string
required
ISO 4217 code for both prices.
integer
required
Tickets available in this listing.
integer[]
required
The quantities you will sell in one purchase. An allow-list, not a range.[2, 4] means 2 or 4, never 3. Send your system’s array exactly as it is. Most multi-value arrays have a gap, so reducing them to a minimum and maximum produces orders that always fail. A 0 in the array is ignored.
boolean
required
The seller holds the tickets right now and can start delivery immediately. false is normal for tickets sold months ahead and does not mean undeliverable. Pair it with inHandOn.
string
ISO 8601 date the seller expects to be able to deliver. Send it whenever inHand is false.
boolean
required
The ticket can be handed over immediately after purchase. This is about the ticket.
boolean
default:"false"
Your system accepts an order for this listing on the spot, with no human broker involved. This is about the order, and it is independent of instantDelivery. When false, Retail tells the buyer their ticket is being confirmed and waits for acceptance.
boolean
Your system’s own yes/no e-ticket flag, if it has one, sent next to format. A listing with format: "eticket" and vendorEticketFlag: false is withheld, because that disagreement usually means a mobile ticket mislabelled as an e-ticket.
string
A price-lock token, if your system issues one. Retail sends it back as listingSignature on the order.
string
Seller notes a buyer may read, for example “Obstructed view”.
any
Your system’s listing payload, untouched. Stored with the order as evidence of what was bought. It must not contain buyer data.
{"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":[{"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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"vendor-api/listings","slug":"/vendor-api/listings","pageMetadata":{"title":"Listings","api":"GET https://integration.example.com/api/vendor/v1/listings","playground":"none","description":"Return what is for sale on one event, right now","href":"/vendor-api/listings"},"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: \"Return what is for sale on one event, right now\"\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`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Table,Warning}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`listings`,children:`Listings`}),`\n`,_jsx(_components.p,{children:`Returns every listing currently for sale on one event. Retail calls this while a buyer’s page is loading, filters the results by its own rules, and shows what passes. Nothing here is stored.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Answer within 4.5 seconds, and never retry internally.`}),` The buyer’s page has a hard budget. A slow success is worse than a fast failure, because by the time it arrives the page has already rendered the event as unavailable.`]})}),`\n`,_jsxs(_components.p,{children:[`Listings are `,_jsx(_components.strong,{children:`quotes, not inventory`}),`. A `,_jsx(_components.code,{children:`vendorListingId`}),` may change between calls, and a listing that has been bought should disappear from the response, not report quantity 0.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`vendorKey`,type:`string`,required:true,id:`param-vendor-key`,children:_jsx(_components.p,{children:`Your supplier identifier.`})}),`\n`,_jsx(ParamField,{query:`vendorEventId`,type:`string`,required:true,id:`param-vendor-event-id`,children:_jsxs(_components.p,{children:[`The event, as you returned it from `,_jsx(_components.a,{href:`/vendor-api/catalog`,children:`Catalog`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Return `,_jsx(_components.code,{children:`{ \"listings\": [] }`}),` when the event genuinely has nothing for sale. If you could not ask your system, return an error instead: an empty list shows a live event as sold out, and nobody investigates a sold-out event.`]}),`\n`,_jsx(ResponseField,{name:`listings`,type:`array`,required:true,id:`param-listings`,children:_jsxs(Expandable,{title:`Listing object`,children:[_jsx(ResponseField,{name:`vendorListingId`,type:`string`,required:true,id:`param-vendor-listing-id`,children:_jsx(_components.p,{children:`Your id for this listing. Retail sends it back on quote and order.`})}),_jsx(ResponseField,{name:`vendorEventId`,type:`string`,required:true,id:`param-vendor-event-id-1`,children:_jsx(_components.p,{children:`The event this listing belongs to.`})}),_jsxs(ResponseField,{name:`format`,type:`string`,required:true,id:`param-format`,children:[_jsx(_components.p,{children:`How the ticket reaches the buyer. One of:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`eticket`})}),_jsx(_components.td,{children:`A printable or scannable ticket with a barcode Retail can retrieve.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mobile_transfer`})}),_jsx(_components.td,{children:`Transferred into the buyer’s own account with the box office, addressed to their email.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`flash_seats`})}),_jsx(_components.td,{children:`An account-based mobile ticket, also delivered to the buyer’s email.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`physical`})}),_jsx(_components.td,{children:`A paper ticket couriered to an address.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`local_pickup`})}),_jsx(_components.td,{children:`Collected at the venue or another location.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`paperless`})}),_jsx(_components.td,{children:`Entry by card or ID, no ticket to hand over.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`You cannot tell. Never sold.`})]})]})]}),_jsx(_components.p,{children:`Classify from your system’s delivery-method field, not from a yes/no “e-ticket” flag. A flag like that is often true for mobile transfers too, and overstates e-ticket supply several times over.`})]}),_jsx(ResponseField,{name:`productKind`,type:`string`,default:`ticket`,id:`param-product-kind`,children:_jsxs(_components.p,{children:[`What the listing `,_jsx(_components.strong,{children:`is`}),`: `,_jsx(_components.code,{children:`ticket`}),` (admission), `,_jsx(_components.code,{children:`parking`}),`, or `,_jsx(_components.code,{children:`other`}),`. A parking pass is delivered exactly like an e-ticket, so nothing else in the payload tells it apart from a seat. `,_jsx(_components.strong,{children:`Always send this.`}),` It defaults to `,_jsx(_components.code,{children:`ticket`}),`, and an add-on without it will be sold as admission.`]})}),_jsx(ResponseField,{name:`section`,type:`string`,id:`param-section`,children:_jsx(_components.p,{children:`Section name as printed on the ticket.`})}),_jsx(ResponseField,{name:`row`,type:`string`,id:`param-row`,children:_jsx(_components.p,{children:`Row.`})}),_jsx(ResponseField,{name:`wholesalePrice`,type:`number`,required:true,id:`param-wholesale-price`,children:_jsx(_components.p,{children:`Price per ticket Gomry Retail pays you.`})}),_jsx(ResponseField,{name:`retailPrice`,type:`number`,required:true,id:`param-retail-price`,children:_jsxs(_components.p,{children:[`Your suggested retail price per ticket. A reference for pricing only: Gomry sets its own price from `,_jsx(_components.code,{children:`wholesalePrice`}),`.`]})}),_jsx(ResponseField,{name:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsx(_components.p,{children:`ISO 4217 code for both prices.`})}),_jsx(ResponseField,{name:`availableQuantity`,type:`integer`,required:true,id:`param-available-quantity`,children:_jsx(_components.p,{children:`Tickets available in this listing.`})}),_jsx(ResponseField,{name:`splits`,type:`integer[]`,required:true,id:`param-splits`,children:_jsxs(_components.p,{children:[`The quantities you will sell in one purchase. `,_jsx(_components.strong,{children:`An allow-list, not a range.`}),` `,_jsx(_components.code,{children:`[2, 4]`}),` means 2 or 4, never 3. Send your system’s array exactly as it is. Most multi-value arrays have a gap, so reducing them to a minimum and maximum produces orders that always fail. A `,_jsx(_components.code,{children:`0`}),` in the array is ignored.`]})}),_jsx(ResponseField,{name:`inHand`,type:`boolean`,required:true,id:`param-in-hand`,children:_jsxs(_components.p,{children:[`The seller holds the tickets right now and can start delivery immediately. `,_jsx(_components.code,{children:`false`}),` is normal for tickets sold months ahead and does `,_jsx(_components.strong,{children:`not`}),` mean undeliverable. Pair it with `,_jsx(_components.code,{children:`inHandOn`}),`.`]})}),_jsx(ResponseField,{name:`inHandOn`,type:`string`,id:`param-in-hand-on`,children:_jsxs(_components.p,{children:[`ISO 8601 date the seller expects to be able to deliver. Send it whenever `,_jsx(_components.code,{children:`inHand`}),` is `,_jsx(_components.code,{children:`false`}),`.`]})}),_jsx(ResponseField,{name:`instantDelivery`,type:`boolean`,required:true,id:`param-instant-delivery`,children:_jsxs(_components.p,{children:[`The ticket can be handed over immediately after purchase. This is about the `,_jsx(_components.strong,{children:`ticket`}),`.`]})}),_jsx(ResponseField,{name:`automated`,type:`boolean`,default:`false`,id:`param-automated`,children:_jsxs(_components.p,{children:[`Your system accepts an order for this listing on the spot, with no human broker involved. This is about the `,_jsx(_components.strong,{children:`order`}),`, and it is independent of `,_jsx(_components.code,{children:`instantDelivery`}),`. When `,_jsx(_components.code,{children:`false`}),`, Retail tells the buyer their ticket is being confirmed and waits for acceptance.`]})}),_jsx(ResponseField,{name:`vendorEticketFlag`,type:`boolean`,id:`param-vendor-eticket-flag`,children:_jsxs(_components.p,{children:[`Your system’s own yes/no e-ticket flag, if it has one, sent next to `,_jsx(_components.code,{children:`format`}),`. A listing with `,_jsx(_components.code,{children:`format: \"eticket\"`}),` and `,_jsx(_components.code,{children:`vendorEticketFlag: false`}),` is withheld, because that disagreement usually means a mobile ticket mislabelled as an e-ticket.`]})}),_jsx(ResponseField,{name:`signature`,type:`string`,id:`param-signature`,children:_jsxs(_components.p,{children:[`A price-lock token, if your system issues one. Retail sends it back as `,_jsx(_components.code,{children:`listingSignature`}),` on the order.`]})}),_jsx(ResponseField,{name:`publicNotes`,type:`string`,id:`param-public-notes`,children:_jsx(_components.p,{children:`Seller notes a buyer may read, for example “Obstructed view”.`})}),_jsx(ResponseField,{name:`raw`,type:`any`,id:`param-raw`,children:_jsx(_components.p,{children:`Your system’s listing payload, untouched. Stored with the order as evidence of what was bought. It must not contain buyer data.`})})]})})]})}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":"Listings","api":"GET https://integration.example.com/api/vendor/v1/listings","playground":"none","description":"Return what is for sale on one event, right now","href":"/vendor-api/listings"}}},"mdxSourceWithNoJs":{"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,ParamField,RequestExample,ResponseExample,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`listings`,children:`Listings`}),`\n`,_jsx(_components.p,{children:`Returns every listing currently for sale on one event. Retail calls this while a buyer’s page is loading, filters the results by its own rules, and shows what passes. Nothing here is stored.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Answer within 4.5 seconds, and never retry internally.`}),` The buyer’s page has a hard budget. A slow success is worse than a fast failure, because by the time it arrives the page has already rendered the event as unavailable.`]})}),`\n`,_jsxs(_components.p,{children:[`Listings are `,_jsx(_components.strong,{children:`quotes, not inventory`}),`. A `,_jsx(_components.code,{children:`vendorListingId`}),` may change between calls, and a listing that has been bought should disappear from the response, not report quantity 0.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`vendorKey`,type:`string`,required:true,id:`param-vendor-key`,children:_jsx(_components.p,{children:`Your supplier identifier.`})}),`\n`,_jsx(ParamField,{query:`vendorEventId`,type:`string`,required:true,id:`param-vendor-event-id`,children:_jsxs(_components.p,{children:[`The event, as you returned it from `,_jsx(_components.a,{href:`/vendor-api/catalog`,children:`Catalog`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Return `,_jsx(_components.code,{children:`{ \"listings\": [] }`}),` when the event genuinely has nothing for sale. If you could not ask your system, return an error instead: an empty list shows a live event as sold out, and nobody investigates a sold-out event.`]}),`\n`,_jsx(ResponseField,{name:`listings`,type:`array`,required:true,id:`param-listings`,children:_jsxs(Expandable,{title:`Listing object`,children:[_jsx(ResponseField,{name:`vendorListingId`,type:`string`,required:true,id:`param-vendor-listing-id`,children:_jsx(_components.p,{children:`Your id for this listing. Retail sends it back on quote and order.`})}),_jsx(ResponseField,{name:`vendorEventId`,type:`string`,required:true,id:`param-vendor-event-id-1`,children:_jsx(_components.p,{children:`The event this listing belongs to.`})}),_jsxs(ResponseField,{name:`format`,type:`string`,required:true,id:`param-format`,children:[_jsx(_components.p,{children:`How the ticket reaches the buyer. One of:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`eticket`})}),_jsx(_components.td,{children:`A printable or scannable ticket with a barcode Retail can retrieve.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mobile_transfer`})}),_jsx(_components.td,{children:`Transferred into the buyer’s own account with the box office, addressed to their email.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`flash_seats`})}),_jsx(_components.td,{children:`An account-based mobile ticket, also delivered to the buyer’s email.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`physical`})}),_jsx(_components.td,{children:`A paper ticket couriered to an address.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`local_pickup`})}),_jsx(_components.td,{children:`Collected at the venue or another location.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`paperless`})}),_jsx(_components.td,{children:`Entry by card or ID, no ticket to hand over.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`You cannot tell. Never sold.`})]})]})]}),_jsx(_components.p,{children:`Classify from your system’s delivery-method field, not from a yes/no “e-ticket” flag. A flag like that is often true for mobile transfers too, and overstates e-ticket supply several times over.`})]}),_jsx(ResponseField,{name:`productKind`,type:`string`,default:`ticket`,id:`param-product-kind`,children:_jsxs(_components.p,{children:[`What the listing `,_jsx(_components.strong,{children:`is`}),`: `,_jsx(_components.code,{children:`ticket`}),` (admission), `,_jsx(_components.code,{children:`parking`}),`, or `,_jsx(_components.code,{children:`other`}),`. A parking pass is delivered exactly like an e-ticket, so nothing else in the payload tells it apart from a seat. `,_jsx(_components.strong,{children:`Always send this.`}),` It defaults to `,_jsx(_components.code,{children:`ticket`}),`, and an add-on without it will be sold as admission.`]})}),_jsx(ResponseField,{name:`section`,type:`string`,id:`param-section`,children:_jsx(_components.p,{children:`Section name as printed on the ticket.`})}),_jsx(ResponseField,{name:`row`,type:`string`,id:`param-row`,children:_jsx(_components.p,{children:`Row.`})}),_jsx(ResponseField,{name:`wholesalePrice`,type:`number`,required:true,id:`param-wholesale-price`,children:_jsx(_components.p,{children:`Price per ticket Gomry Retail pays you.`})}),_jsx(ResponseField,{name:`retailPrice`,type:`number`,required:true,id:`param-retail-price`,children:_jsxs(_components.p,{children:[`Your suggested retail price per ticket. A reference for pricing only: Gomry sets its own price from `,_jsx(_components.code,{children:`wholesalePrice`}),`.`]})}),_jsx(ResponseField,{name:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsx(_components.p,{children:`ISO 4217 code for both prices.`})}),_jsx(ResponseField,{name:`availableQuantity`,type:`integer`,required:true,id:`param-available-quantity`,children:_jsx(_components.p,{children:`Tickets available in this listing.`})}),_jsx(ResponseField,{name:`splits`,type:`integer[]`,required:true,id:`param-splits`,children:_jsxs(_components.p,{children:[`The quantities you will sell in one purchase. `,_jsx(_components.strong,{children:`An allow-list, not a range.`}),` `,_jsx(_components.code,{children:`[2, 4]`}),` means 2 or 4, never 3. Send your system’s array exactly as it is. Most multi-value arrays have a gap, so reducing them to a minimum and maximum produces orders that always fail. A `,_jsx(_components.code,{children:`0`}),` in the array is ignored.`]})}),_jsx(ResponseField,{name:`inHand`,type:`boolean`,required:true,id:`param-in-hand`,children:_jsxs(_components.p,{children:[`The seller holds the tickets right now and can start delivery immediately. `,_jsx(_components.code,{children:`false`}),` is normal for tickets sold months ahead and does `,_jsx(_components.strong,{children:`not`}),` mean undeliverable. Pair it with `,_jsx(_components.code,{children:`inHandOn`}),`.`]})}),_jsx(ResponseField,{name:`inHandOn`,type:`string`,id:`param-in-hand-on`,children:_jsxs(_components.p,{children:[`ISO 8601 date the seller expects to be able to deliver. Send it whenever `,_jsx(_components.code,{children:`inHand`}),` is `,_jsx(_components.code,{children:`false`}),`.`]})}),_jsx(ResponseField,{name:`instantDelivery`,type:`boolean`,required:true,id:`param-instant-delivery`,children:_jsxs(_components.p,{children:[`The ticket can be handed over immediately after purchase. This is about the `,_jsx(_components.strong,{children:`ticket`}),`.`]})}),_jsx(ResponseField,{name:`automated`,type:`boolean`,default:`false`,id:`param-automated`,children:_jsxs(_components.p,{children:[`Your system accepts an order for this listing on the spot, with no human broker involved. This is about the `,_jsx(_components.strong,{children:`order`}),`, and it is independent of `,_jsx(_components.code,{children:`instantDelivery`}),`. When `,_jsx(_components.code,{children:`false`}),`, Retail tells the buyer their ticket is being confirmed and waits for acceptance.`]})}),_jsx(ResponseField,{name:`vendorEticketFlag`,type:`boolean`,id:`param-vendor-eticket-flag`,children:_jsxs(_components.p,{children:[`Your system’s own yes/no e-ticket flag, if it has one, sent next to `,_jsx(_components.code,{children:`format`}),`. A listing with `,_jsx(_components.code,{children:`format: \"eticket\"`}),` and `,_jsx(_components.code,{children:`vendorEticketFlag: false`}),` is withheld, because that disagreement usually means a mobile ticket mislabelled as an e-ticket.`]})}),_jsx(ResponseField,{name:`signature`,type:`string`,id:`param-signature`,children:_jsxs(_components.p,{children:[`A price-lock token, if your system issues one. Retail sends it back as `,_jsx(_components.code,{children:`listingSignature`}),` on the order.`]})}),_jsx(ResponseField,{name:`publicNotes`,type:`string`,id:`param-public-notes`,children:_jsx(_components.p,{children:`Seller notes a buyer may read, for example “Obstructed view”.`})}),_jsx(ResponseField,{name:`raw`,type:`any`,id:`param-raw`,children:_jsx(_components.p,{children:`Your system’s listing payload, untouched. Stored with the order as evidence of what was bought. It must not contain buyer data.`})})]})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,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:`2`,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:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-API-Key: $GOMRY_RETAIL_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://integration.example.com/api/vendor/v1/listings?vendorKey=acme\u0026vendorEventId=3273941\"`})}),`\n`]})})})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`25`,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:`25`,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:` \"listings\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"vendorListingId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tg_88412093\"`}),_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:` \"vendorEventId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3273941\"`}),_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:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"eticket\"`}),_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:` \"productKind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ticket\"`}),_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:` \"section\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"118\"`}),_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:` \"row\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12\"`}),_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:` \"wholesalePrice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`96.0`}),_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:` \"retailPrice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`128.0`}),_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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`}),_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:` \"availableQuantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_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:` \"splits\"`}),_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:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_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:` \"inHand\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"inHandOn\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-12\"`}),_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:` \"instantDelivery\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"automated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"vendorEticketFlag\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"signature\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sig_5f1c2a\"`}),_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:` \"publicNotes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Aisle seats\"`}),_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:` \"raw\"`}),_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`,_jsx(_components.span,{className:`line`,children:_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`]})})}),_jsx(CodeBlock,{filename:`404`,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"not_found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Unknown event 3273941\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`]})})})]})]})}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":"Listings","api":"GET https://integration.example.com/api/vendor/v1/listings","playground":"none","description":"Return what is for sale on one event, right now","href":"/vendor-api/listings"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Listings","slug":"listings","depth":1,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"X-API-Key: $GOMRY_RETAIL_API_KEY\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://integration.example.com/api/vendor/v1/listings?vendorKey=acme\u0026#x26;vendorEventId=3273941\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"25\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"listings\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"vendorListingId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"tg_88412093\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"vendorEventId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"3273941\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"format\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"eticket\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"productKind\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ticket\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"section\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"118\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"row\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"12\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"wholesalePrice\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">96.0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"retailPrice\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">128.0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"USD\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"availableQuantity\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">4\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"splits\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">4\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"inHand\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"inHandOn\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-12\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"instantDelivery\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"automated\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"vendorEticketFlag\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"signature\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"sig_5f1c2a\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"publicNotes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Aisle seats\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"raw\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"404","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"1\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{ \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"not_found\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Unknown event 3273941\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> } }\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Listings","path":"/api/vendor/v1/listings","servers":[{"url":"https://integration.example.com"}],"method":"get","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"X-API-KEY":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{"vendorKey":{"schema":[{"type":"string","description":"Your supplier identifier.","required":true}]},"vendorEventId":{"schema":[{"type":"string","description":"The event, as you returned it from Catalog .","required":true}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"listings":[{"type":"array","items":[{"type":"object","properties":{"vendorListingId":[{"type":"string","description":"Your id for this listing. Retail sends it back on quote and order.","required":true}],"vendorEventId":[{"type":"string","description":"The event this listing belongs to.","required":true}],"format":[{"type":"string","description":"How the ticket reaches the buyer. One of: Value Meaning `eticket` A printable or scannable ticket with a barcode Retail can retrieve. `mobile_transfer` Transferred into the buyer’s own account with the box office, addressed to their email. `flash_seats` An account-based mobile ticket, also delivered to the buyer’s email. `physical` A paper ticket couriered to an address. `local_pickup` Collected at the venue or another location. `paperless` Entry by card or ID, no ticket to hand over. `unknown` You cannot tell. Never sold. Classify from your system’s delivery-method field, not from a yes/no “e-ticket” flag. A flag like that is often true for mobile transfers too, and overstates e-ticket supply several times over.","required":true}],"productKind":[{"type":"string","description":"What the listing is : `ticket` (admission), `parking` , or `other` . A parking pass is delivered exactly like an e-ticket, so nothing else in the payload tells it apart from a seat. Always send this. It defaults to `ticket` , and an add-on without it will be sold as admission."}],"section":[{"type":"string","description":"Section name as printed on the ticket."}],"row":[{"type":"string","description":"Row."}],"wholesalePrice":[{"type":"number","description":"Price per ticket Gomry Retail pays you.","required":true}],"retailPrice":[{"type":"number","description":"Your suggested retail price per ticket. A reference for pricing only: Gomry sets its own price from `wholesalePrice` .","required":true}],"currency":[{"type":"string","description":"ISO 4217 code for both prices.","required":true}],"availableQuantity":[{"type":"integer","description":"Tickets available in this listing.","required":true}],"splits":[{"type":"array","items":[{"type":"integer"}],"description":"The quantities you will sell in one purchase. An allow-list, not a range. `[2, 4]` means 2 or 4, never 3. Send your system’s array exactly as it is. Most multi-value arrays have a gap, so reducing them to a minimum and maximum produces orders that always fail. A `0` in the array is ignored.","required":true}],"inHand":[{"type":"boolean","description":"The seller holds the tickets right now and can start delivery immediately. `false` is normal for tickets sold months ahead and does not mean undeliverable. Pair it with `inHandOn` .","required":true}],"inHandOn":[{"type":"string","description":"ISO 8601 date the seller expects to be able to deliver. Send it whenever `inHand` is `false` ."}],"instantDelivery":[{"type":"boolean","description":"The ticket can be handed over immediately after purchase. This is about the ticket .","required":true}],"automated":[{"type":"boolean","description":"Your system accepts an order for this listing on the spot, with no human broker involved. This is about the order , and it is independent of `instantDelivery` . When `false` , Retail tells the buyer their ticket is being confirmed and waits for acceptance."}],"vendorEticketFlag":[{"type":"boolean","description":"Your system’s own yes/no e-ticket flag, if it has one, sent next to `format` . A listing with `format: \"eticket\"` and `vendorEticketFlag: false` is withheld, because that disagreement usually means a mobile ticket mislabelled as an e-ticket."}],"signature":[{"type":"string","description":"A price-lock token, if your system issues one. Retail sends it back as `listingSignature` on the order."}],"publicNotes":[{"type":"string","description":"Seller notes a buyer may read, for example “Obstructed view”."}],"raw":[{"type":"any","description":"Your system’s listing payload, untouched. Stored with the order as evidence of what was bought. It must not contain buyer data."}]}}],"required":true}]}}],"examples":{"example":{"value":{"listings":[{"vendorListingId":"\u003cstring>","vendorEventId":"\u003cstring>","format":"\u003cstring>","productKind":"\u003cstring>","section":"\u003cstring>","row":"\u003cstring>","wholesalePrice":123,"retailPrice":123,"currency":"\u003cstring>","availableQuantity":123,"splits":[123],"inHand":true,"inHandOn":"\u003cstring>","instantDelivery":true,"automated":true,"vendorEticketFlag":true,"signature":"\u003cstring>","publicNotes":"\u003cstring>","raw":"\u003cany>"}]}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"gomry","siteName":"Gomry API","title":"Listings - Gomry API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-01T12:48:00.184Z","originalFileLocation":"vendor-api/listings.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=\"Return what is for sale on one event, right now\">\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=\"Listings - Gomry API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return what is for sale on one event, right now\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gomry API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gomry.com/vendor-api/listings\">\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=Catalog+and+Listings\u0026amp;title=Listings\u0026amp;description=Return+what+is+for+sale+on+one+event%2C+right+now\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=933f537059ee086783ff57d4e22511e2c9e96ab773b70f4af766c8251e75df96\">\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=\"Listings - Gomry API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return what is for sale on one event, right now\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gomry.mintlify.site/_mintlify/api/og/v2?division=Catalog+and+Listings\u0026amp;title=Listings\u0026amp;description=Return+what+is+for+sale+on+one+event%2C+right+now\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=933f537059ee086783ff57d4e22511e2c9e96ab773b70f4af766c8251e75df96\">\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/vendor-api/listings\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/vendor-api/listings.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/vendor-api/listings#webpage\",\"url\":\"https://docs.gomry.com/vendor-api/listings\",\"name\":\"Listings\",\"description\":\"Return what is for sale on one event, right now\",\"dateModified\":\"2026-10-01T12:48:00.184Z\",\"isPartOf\":{\"@id\":\"https://docs.gomry.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomry.com/vendor-api/listings#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomry.com/vendor-api/listings#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Catalog and Listings\",\"item\":\"https://docs.gomry.com/vendor-api/catalog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Listings\",\"item\":\"https://docs.gomry.com/vendor-api/listings\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomry.com/vendor-api/listings#apireference\",\"headline\":\"Listings\",\"name\":\"Listings\",\"description\":\"Return what is for sale on one event, right now\",\"url\":\"https://docs.gomry.com/vendor-api/listings\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomry.com/vendor-api/listings#webpage\"},\"dateModified\":\"2026-10-01T12:48:00.184Z\",\"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":"/vendor-api/listings.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","groups":[{"group":"Overview","pages":[{"title":"Vendor API","href":"/vendor-api/introduction"},{"title":"Authentication and Errors","href":"/vendor-api/authentication"},{"title":"Webhooks to Retail","href":"/vendor-api/webhooks"},{"title":"Going Live","href":"/vendor-api/going-live"}]},{"group":"Catalog and Listings","pages":[{"title":"Catalog","api":"GET https://integration.example.com/api/vendor/v1/catalog","playground":"none","description":"Return your events, one page at a time","href":"/vendor-api/catalog"},{"title":"Listings","api":"GET https://integration.example.com/api/vendor/v1/listings","playground":"none","href":"/vendor-api/listings"},{"title":"Venue Map","api":"GET https://integration.example.com/api/vendor/v1/venue-map","playground":"none","description":"Return the venue map for an event as image bytes, never as a link","href":"/vendor-api/venue-map"}]},{"group":"Purchasing","pages":[{"title":"Quote","api":"POST https://integration.example.com/api/vendor/v1/quote","playground":"none","href":"/vendor-api/quote"},{"title":"Place Order","api":"POST https://integration.example.com/api/vendor/v1/orders","playground":"none","href":"/vendor-api/place-order"},{"title":"Search Orders","api":"GET https://integration.example.com/api/vendor/v1/orders","playground":"none","href":"/vendor-api/search-orders"}]},{"group":"Delivery","pages":[{"title":"Fulfilment","api":"GET https://integration.example.com/api/vendor/v1/fulfilment","playground":"none","href":"/vendor-api/fulfilment"},{"title":"Credentials","api":"GET https://integration.example.com/api/vendor/v1/credentials","playground":"none","href":"/vendor-api/credentials"}]}]},{"tab":"Distribution API","pages":[{"title":"Distribution API","href":"/distribution-api/introduction"}]}]},{"anchor":"Support","icon":"envelope","href":"mailto:support@gomry.com"}]},"basePath":"","title":"Listings - 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"]}