Returns your events: what could be sold, as opposed to what is for sale right now. Retail polls this every 15 minutes and stores the results. It is the only endpoint whose data Retail keeps.
A catalog entry is a durable description of a real event, safe to store and show. A listing is a quote with a short life. Keep the two apart: nothing here should say how many tickets are purchasable.
Query Parameters
string
required
Your supplier identifier.
integer
default:"1"
1-based page number.
string
ISO 8601 instant. Return only events changed since then. When absent, Retail is doing a full sweep. If your system has no modified-since filter you may ignore this parameter and return everything.
string
Look up a single event, used when Retail re-reads one that looks stale. Optional to support: if you ignore it and return an ordinary page, Retail keeps only the matching row.
Paging
Paging is required. A real catalog runs to tens of thousands of events, and answering in one response will time out. Size your pages so each answers within 30 seconds.
nextPage: null is the only end-of-catalog signal. An empty events array on a page in the middle is treated as a hiccup, not the end. Retail uses absence from the catalog to flag events for review, so ending early by mistake looks like you dropped every event after that page.
Response
array
required
Show Event object
string
required
Your id for the event, as a string.
string
required
Event name as a buyer should read it.
string | null
The start instant in UTC, ISO 8601.Do not create this by appending Z to a local time. Some systems do, which shifts events by hours. If you cannot convert honestly, send null and fill occursAtLocal instead. Retail prefers rebuilding the instant from local time.
string | null
The local wall-clock start as your system states it, ISO 8601 with offset, for example 2026-11-14T20:00:00-05:00.
boolean
true when the date or time is not confirmed. A placeholder time such as midnight otherwise shows to a buyer as a real “12:00 AM” start.
object
Omit the whole object if you have no venue data. Never send a venue without a name.
Show Venue object
string
required
Venue name.
string
Street address.
string
City.
string
State or region.
string
ISO 3166-1 alpha-2, for example US.
string
Postal code.
number
Latitude.
number
Longitude.
string
IANA zone, for example Europe/Madrid. Send it whenever you have it. Without it Retail has to derive the zone, and when that fails the event is stored in UTC and shows the wrong start time.
string
Your category, for example Concerts.
string[]
default:"[]"
Performers or teams, headliner first.
string
Your lifecycle state for the event, in your own vocabulary, for example shown, postponed or rescheduled. ignored means not for sale, and Retail never shows it to a buyer.
string | null
Your last-modified stamp for the event. Drives incremental sync.
integer
Indicative only. How many listings you see on the event, never a purchasable quantity. Retail stores it as an observation and gets real supply from listings.
string
Optional. Retail does not show this URL to buyers. Maps are served through Venue map.
integer | null
required
The next page number, or null when the catalog is exhausted.
{"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/catalog","slug":"/vendor-api/catalog","pageMetadata":{"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"},"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 your events, one page at a time\"\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`,..._provideComponents(),...props.components},{Expandable,Heading,Note,ParamField,ResponseField,Warning}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`catalog`,children:`Catalog`}),`\n`,_jsxs(_components.p,{children:[`Returns your events: what `,_jsx(_components.strong,{children:`could`}),` be sold, as opposed to what is for sale right now. Retail polls this every 15 minutes and stores the results. It is the only endpoint whose data Retail keeps.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`A catalog entry is a durable description of a real event, safe to store and show. A `,_jsx(_components.a,{href:`/vendor-api/listings`,children:`listing`}),` is a quote with a short life. Keep the two apart: nothing here should say how many tickets are purchasable.`]})}),`\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:`page`,type:`integer`,default:`1`,id:`param-page`,children:_jsx(_components.p,{children:`1-based page number.`})}),`\n`,_jsx(ParamField,{query:`updatedSince`,type:`string`,id:`param-updated-since`,children:_jsx(_components.p,{children:`ISO 8601 instant. Return only events changed since then. When absent, Retail is doing a full sweep. If your system has no modified-since filter you may ignore this parameter and return everything.`})}),`\n`,_jsx(ParamField,{query:`vendorEventId`,type:`string`,id:`param-vendor-event-id`,children:_jsx(_components.p,{children:`Look up a single event, used when Retail re-reads one that looks stale. Optional to support: if you ignore it and return an ordinary page, Retail keeps only the matching row.`})}),`\n`,_jsx(Heading,{level:`2`,id:`paging`,children:`Paging`}),`\n`,_jsxs(_components.p,{children:[`Paging is required. A real catalog runs to tens of thousands of events, and answering in one response will time out. Size your pages so each answers within `,_jsx(_components.strong,{children:`30 seconds`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`nextPage: null`}),` is the only end-of-catalog signal.`]}),` An empty `,_jsx(_components.code,{children:`events`}),` array on a page in the middle is treated as a hiccup, not the end. Retail uses absence from the catalog to flag events for review, so ending early by mistake looks like you dropped every event after that page.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`events`,type:`array`,required:true,id:`param-events`,children:_jsxs(Expandable,{title:`Event object`,children:[_jsx(ResponseField,{name:`vendorEventId`,type:`string`,required:true,id:`param-vendor-event-id-1`,children:_jsx(_components.p,{children:`Your id for the event, as a string.`})}),_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Event name as a buyer should read it.`})}),_jsxs(ResponseField,{name:`occursAt`,type:`string | null`,id:`param-occurs-at`,children:[_jsx(_components.p,{children:`The start instant in UTC, ISO 8601.`}),_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Do not create this by appending `,_jsx(_components.code,{children:`Z`}),` to a local time.`]}),` Some systems do, which shifts events by hours. If you cannot convert honestly, send `,_jsx(_components.code,{children:`null`}),` and fill `,_jsx(_components.code,{children:`occursAtLocal`}),` instead. Retail prefers rebuilding the instant from local time.`]})]}),_jsx(ResponseField,{name:`occursAtLocal`,type:`string | null`,id:`param-occurs-at-local`,children:_jsxs(_components.p,{children:[`The local wall-clock start as your system states it, ISO 8601 `,_jsx(_components.strong,{children:`with offset`}),`, for example `,_jsx(_components.code,{children:`2026-11-14T20:00:00-05:00`}),`.`]})}),_jsx(ResponseField,{name:`timeTbd`,type:`boolean`,id:`param-time-tbd`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the date or time is not confirmed. A placeholder time such as midnight otherwise shows to a buyer as a real “12:00 AM” start.`]})}),_jsxs(ResponseField,{name:`venue`,type:`object`,id:`param-venue`,children:[_jsx(_components.p,{children:`Omit the whole object if you have no venue data. Never send a venue without a name.`}),_jsxs(Expandable,{title:`Venue object`,children:[_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name-1`,children:`Venue name.`}),_jsx(ResponseField,{name:`streetAddress`,type:`string`,id:`param-street-address`,children:`Street address.`}),_jsx(ResponseField,{name:`locality`,type:`string`,id:`param-locality`,children:`City.`}),_jsx(ResponseField,{name:`region`,type:`string`,id:`param-region`,children:`State or region.`}),_jsxs(ResponseField,{name:`countryCode`,type:`string`,id:`param-country-code`,children:[`ISO 3166-1 alpha-2, for example `,_jsx(_components.code,{children:`US`}),`.`]}),_jsx(ResponseField,{name:`postalCode`,type:`string`,id:`param-postal-code`,children:`Postal code.`}),_jsx(ResponseField,{name:`latitude`,type:`number`,id:`param-latitude`,children:`Latitude.`}),_jsx(ResponseField,{name:`longitude`,type:`number`,id:`param-longitude`,children:`Longitude.`}),_jsx(ResponseField,{name:`timezone`,type:`string`,id:`param-timezone`,children:_jsxs(_components.p,{children:[`IANA zone, for example `,_jsx(_components.code,{children:`Europe/Madrid`}),`. `,_jsx(_components.strong,{children:`Send it whenever you have it.`}),` Without it Retail has to derive the zone, and when that fails the event is stored in UTC and shows the wrong start time.`]})})]})]}),_jsx(ResponseField,{name:`categoryName`,type:`string`,id:`param-category-name`,children:_jsxs(_components.p,{children:[`Your category, for example `,_jsx(_components.code,{children:`Concerts`}),`.`]})}),_jsx(ResponseField,{name:`performerNames`,type:`string[]`,default:`[]`,id:`param-performer-names`,children:_jsx(_components.p,{children:`Performers or teams, headliner first.`})}),_jsx(ResponseField,{name:`state`,type:`string`,id:`param-state`,children:_jsxs(_components.p,{children:[`Your lifecycle state for the event, in your own vocabulary, for example `,_jsx(_components.code,{children:`shown`}),`, `,_jsx(_components.code,{children:`postponed`}),` or `,_jsx(_components.code,{children:`rescheduled`}),`. `,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`ignored`}),` means not for sale`]}),`, and Retail never shows it to a buyer.`]})}),_jsx(ResponseField,{name:`updatedAt`,type:`string | null`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Your last-modified stamp for the event. Drives incremental sync.`})}),_jsx(ResponseField,{name:`availableCount`,type:`integer`,id:`param-available-count`,children:_jsxs(_components.p,{children:[`Indicative only. How many listings you see on the event, `,_jsx(_components.strong,{children:`never`}),` a purchasable quantity. Retail stores it as an observation and gets real supply from listings.`]})}),_jsx(ResponseField,{name:`seatingChartUrl`,type:`string`,id:`param-seating-chart-url`,children:_jsxs(_components.p,{children:[`Optional. Retail does not show this URL to buyers. Maps are served through `,_jsx(_components.a,{href:`/vendor-api/venue-map`,children:`Venue map`}),`.`]})})]})}),`\n`,_jsx(ResponseField,{name:`nextPage`,type:`integer | null`,required:true,id:`param-next-page`,children:_jsxs(_components.p,{children:[`The next page number, or `,_jsx(_components.code,{children:`null`}),` when the catalog is exhausted.`]})})]})}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":"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"}}},"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`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,RequestExample,ResponseExample,ResponseField,Warning}=_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(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`catalog`,children:`Catalog`}),`\n`,_jsxs(_components.p,{children:[`Returns your events: what `,_jsx(_components.strong,{children:`could`}),` be sold, as opposed to what is for sale right now. Retail polls this every 15 minutes and stores the results. It is the only endpoint whose data Retail keeps.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`A catalog entry is a durable description of a real event, safe to store and show. A `,_jsx(_components.a,{href:`/vendor-api/listings`,children:`listing`}),` is a quote with a short life. Keep the two apart: nothing here should say how many tickets are purchasable.`]})}),`\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:`page`,type:`integer`,default:`1`,id:`param-page`,children:_jsx(_components.p,{children:`1-based page number.`})}),`\n`,_jsx(ParamField,{query:`updatedSince`,type:`string`,id:`param-updated-since`,children:_jsx(_components.p,{children:`ISO 8601 instant. Return only events changed since then. When absent, Retail is doing a full sweep. If your system has no modified-since filter you may ignore this parameter and return everything.`})}),`\n`,_jsx(ParamField,{query:`vendorEventId`,type:`string`,id:`param-vendor-event-id`,children:_jsx(_components.p,{children:`Look up a single event, used when Retail re-reads one that looks stale. Optional to support: if you ignore it and return an ordinary page, Retail keeps only the matching row.`})}),`\n`,_jsx(Heading,{level:`2`,id:`paging`,children:`Paging`}),`\n`,_jsxs(_components.p,{children:[`Paging is required. A real catalog runs to tens of thousands of events, and answering in one response will time out. Size your pages so each answers within `,_jsx(_components.strong,{children:`30 seconds`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`nextPage: null`}),` is the only end-of-catalog signal.`]}),` An empty `,_jsx(_components.code,{children:`events`}),` array on a page in the middle is treated as a hiccup, not the end. Retail uses absence from the catalog to flag events for review, so ending early by mistake looks like you dropped every event after that page.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`events`,type:`array`,required:true,id:`param-events`,children:_jsxs(Expandable,{title:`Event object`,children:[_jsx(ResponseField,{name:`vendorEventId`,type:`string`,required:true,id:`param-vendor-event-id-1`,children:_jsx(_components.p,{children:`Your id for the event, as a string.`})}),_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Event name as a buyer should read it.`})}),_jsxs(ResponseField,{name:`occursAt`,type:`string | null`,id:`param-occurs-at`,children:[_jsx(_components.p,{children:`The start instant in UTC, ISO 8601.`}),_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Do not create this by appending `,_jsx(_components.code,{children:`Z`}),` to a local time.`]}),` Some systems do, which shifts events by hours. If you cannot convert honestly, send `,_jsx(_components.code,{children:`null`}),` and fill `,_jsx(_components.code,{children:`occursAtLocal`}),` instead. Retail prefers rebuilding the instant from local time.`]})]}),_jsx(ResponseField,{name:`occursAtLocal`,type:`string | null`,id:`param-occurs-at-local`,children:_jsxs(_components.p,{children:[`The local wall-clock start as your system states it, ISO 8601 `,_jsx(_components.strong,{children:`with offset`}),`, for example `,_jsx(_components.code,{children:`2026-11-14T20:00:00-05:00`}),`.`]})}),_jsx(ResponseField,{name:`timeTbd`,type:`boolean`,id:`param-time-tbd`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the date or time is not confirmed. A placeholder time such as midnight otherwise shows to a buyer as a real “12:00 AM” start.`]})}),_jsxs(ResponseField,{name:`venue`,type:`object`,id:`param-venue`,children:[_jsx(_components.p,{children:`Omit the whole object if you have no venue data. Never send a venue without a name.`}),_jsxs(Expandable,{title:`Venue object`,children:[_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name-1`,children:`Venue name.`}),_jsx(ResponseField,{name:`streetAddress`,type:`string`,id:`param-street-address`,children:`Street address.`}),_jsx(ResponseField,{name:`locality`,type:`string`,id:`param-locality`,children:`City.`}),_jsx(ResponseField,{name:`region`,type:`string`,id:`param-region`,children:`State or region.`}),_jsxs(ResponseField,{name:`countryCode`,type:`string`,id:`param-country-code`,children:[`ISO 3166-1 alpha-2, for example `,_jsx(_components.code,{children:`US`}),`.`]}),_jsx(ResponseField,{name:`postalCode`,type:`string`,id:`param-postal-code`,children:`Postal code.`}),_jsx(ResponseField,{name:`latitude`,type:`number`,id:`param-latitude`,children:`Latitude.`}),_jsx(ResponseField,{name:`longitude`,type:`number`,id:`param-longitude`,children:`Longitude.`}),_jsx(ResponseField,{name:`timezone`,type:`string`,id:`param-timezone`,children:_jsxs(_components.p,{children:[`IANA zone, for example `,_jsx(_components.code,{children:`Europe/Madrid`}),`. `,_jsx(_components.strong,{children:`Send it whenever you have it.`}),` Without it Retail has to derive the zone, and when that fails the event is stored in UTC and shows the wrong start time.`]})})]})]}),_jsx(ResponseField,{name:`categoryName`,type:`string`,id:`param-category-name`,children:_jsxs(_components.p,{children:[`Your category, for example `,_jsx(_components.code,{children:`Concerts`}),`.`]})}),_jsx(ResponseField,{name:`performerNames`,type:`string[]`,default:`[]`,id:`param-performer-names`,children:_jsx(_components.p,{children:`Performers or teams, headliner first.`})}),_jsx(ResponseField,{name:`state`,type:`string`,id:`param-state`,children:_jsxs(_components.p,{children:[`Your lifecycle state for the event, in your own vocabulary, for example `,_jsx(_components.code,{children:`shown`}),`, `,_jsx(_components.code,{children:`postponed`}),` or `,_jsx(_components.code,{children:`rescheduled`}),`. `,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`ignored`}),` means not for sale`]}),`, and Retail never shows it to a buyer.`]})}),_jsx(ResponseField,{name:`updatedAt`,type:`string | null`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Your last-modified stamp for the event. Drives incremental sync.`})}),_jsx(ResponseField,{name:`availableCount`,type:`integer`,id:`param-available-count`,children:_jsxs(_components.p,{children:[`Indicative only. How many listings you see on the event, `,_jsx(_components.strong,{children:`never`}),` a purchasable quantity. Retail stores it as an observation and gets real supply from listings.`]})}),_jsx(ResponseField,{name:`seatingChartUrl`,type:`string`,id:`param-seating-chart-url`,children:_jsxs(_components.p,{children:[`Optional. Retail does not show this URL to buyers. Maps are served through `,_jsx(_components.a,{href:`/vendor-api/venue-map`,children:`Venue map`}),`.`]})})]})}),`\n`,_jsx(ResponseField,{name:`nextPage`,type:`integer | null`,required:true,id:`param-next-page`,children:_jsxs(_components.p,{children:[`The next page number, or `,_jsx(_components.code,{children:`null`}),` when the catalog is exhausted.`]})}),`\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/catalog?vendorKey=acme\u0026page=1\u0026updatedSince=2026-09-30T00:00:00.000Z\"`})}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200`,numberOfLines:`27`,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:`27`,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:` \"events\"`}),_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:` \"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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"City FC vs United\"`}),_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:` \"occursAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-14T20: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:` \"occursAtLocal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-14T15:00:00-05:00\"`}),_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:` \"timeTbd\"`}),_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:` \"venue\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Riverside Stadium\"`}),_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:` \"locality\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Philadelphia\"`}),_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:` \"region\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PA\"`}),_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:` \"countryCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"US\"`}),_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:` \"postalCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"19148\"`}),_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:` \"latitude\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`39.9008`}),_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:` \"longitude\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`-75.1675`}),_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:` \"timezone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"America/New_York\"`})]}),`\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:` \"categoryName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Soccer\"`}),_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:` \"performerNames\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"City FC\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"United\"`}),_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:` \"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"shown\"`}),_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:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-29T11:42:10.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:` \"availableCount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`174`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nextPage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_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":"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"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Catalog","slug":"catalog","depth":1,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Paging","slug":"paging","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/catalog?vendorKey=acme\u0026#x26;page=1\u0026#x26;updatedSince=2026-09-30T00:00:00.000Z\"\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=\"27\">\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\"> \"events\"\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\"> \"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\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"City FC vs United\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"occursAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-14T20:00:00.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"occursAtLocal\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-14T15:00:00-05:00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"timeTbd\"\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\"> \"venue\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Riverside Stadium\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"locality\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Philadelphia\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"region\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PA\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"countryCode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"US\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"postalCode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"19148\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"latitude\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">39.9008\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"longitude\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">-75.1675\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"timezone\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"America/New_York\"\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\"> \"categoryName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Soccer\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"performerNames\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"City FC\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"United\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"state\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"shown\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"updatedAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-09-29T11:42:10.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"availableCount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">174\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:#116329;--shiki-dark:#9CDCFE\"> \"nextPage\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Catalog","path":"/api/vendor/v1/catalog","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}]},"page":{"schema":[{"type":"integer","description":"1-based page number."}]},"updatedSince":{"schema":[{"type":"string","description":"ISO 8601 instant. Return only events changed since then. When absent, Retail is doing a full sweep. If your system has no modified-since filter you may ignore this parameter and return everything."}]},"vendorEventId":{"schema":[{"type":"string","description":"Look up a single event, used when Retail re-reads one that looks stale. Optional to support: if you ignore it and return an ordinary page, Retail keeps only the matching row."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"events":[{"type":"array","items":[{"type":"object","properties":{"vendorEventId":[{"type":"string","description":"Your id for the event, as a string.","required":true}],"name":[{"type":"string","description":"Event name as a buyer should read it.","required":true}],"occursAt":[{"type":"object","properties":{},"description":"The start instant in UTC, ISO 8601. Do not create this by appending `Z` to a local time. Some systems do, which shifts events by hours. If you cannot convert honestly, send `null` and fill `occursAtLocal` instead. Retail prefers rebuilding the instant from local time."}],"occursAtLocal":[{"type":"object","properties":{},"description":"The local wall-clock start as your system states it, ISO 8601 with offset , for example `2026-11-14T20:00:00-05:00` ."}],"timeTbd":[{"type":"boolean","description":"`true` when the date or time is not confirmed. A placeholder time such as midnight otherwise shows to a buyer as a real “12:00 AM” start."}],"venue":[{"type":"object","properties":{"name":[{"type":"string","description":"Venue name.","required":true}],"streetAddress":[{"type":"string","description":"Street address."}],"locality":[{"type":"string","description":"City."}],"region":[{"type":"string","description":"State or region."}],"countryCode":[{"type":"string","description":"ISO 3166-1 alpha-2, for example `US` ."}],"postalCode":[{"type":"string","description":"Postal code."}],"latitude":[{"type":"number","description":"Latitude."}],"longitude":[{"type":"number","description":"Longitude."}],"timezone":[{"type":"string","description":"IANA zone, for example `Europe/Madrid` . Send it whenever you have it. Without it Retail has to derive the zone, and when that fails the event is stored in UTC and shows the wrong start time."}]},"description":"Omit the whole object if you have no venue data. Never send a venue without a name."}],"categoryName":[{"type":"string","description":"Your category, for example `Concerts` ."}],"performerNames":[{"type":"array","items":[{"type":"string"}],"description":"Performers or teams, headliner first."}],"state":[{"type":"string","description":"Your lifecycle state for the event, in your own vocabulary, for example `shown` , `postponed` or `rescheduled` . `ignored` means not for sale , and Retail never shows it to a buyer."}],"updatedAt":[{"type":"object","properties":{},"description":"Your last-modified stamp for the event. Drives incremental sync."}],"availableCount":[{"type":"integer","description":"Indicative only. How many listings you see on the event, never a purchasable quantity. Retail stores it as an observation and gets real supply from listings."}],"seatingChartUrl":[{"type":"string","description":"Optional. Retail does not show this URL to buyers. Maps are served through Venue map ."}]}}],"required":true}],"nextPage":[{"type":"object","properties":{},"description":"The next page number, or `null` when the catalog is exhausted.","required":true}]}}],"examples":{"example":{"value":{"events":[{"vendorEventId":"\u003cstring>","name":"\u003cstring>","occursAt":{},"occursAtLocal":{},"timeTbd":true,"venue":{"name":"\u003cstring>","streetAddress":"\u003cstring>","locality":"\u003cstring>","region":"\u003cstring>","countryCode":"\u003cstring>","postalCode":"\u003cstring>","latitude":123,"longitude":123,"timezone":"\u003cstring>"},"categoryName":"\u003cstring>","performerNames":["\u003cstring>"],"state":"\u003cstring>","updatedAt":{},"availableCount":123,"seatingChartUrl":"\u003cstring>"}],"nextPage":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"gomry","siteName":"Gomry API","title":"Catalog - Gomry API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-01T12:48:00.182Z","originalFileLocation":"vendor-api/catalog.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 your events, one page at a time\">\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=\"Catalog - Gomry API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return your events, one page at a time\">\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/catalog\">\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=Catalog\u0026amp;description=Return+your+events%2C+one+page+at+a+time\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=b8152ce48e3263f323ba31b3a347a6e982e61a0914af7f4a7095bbdd9d3b8ff2\">\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=\"Catalog - Gomry API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return your events, one page at a time\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gomry.mintlify.site/_mintlify/api/og/v2?division=Catalog+and+Listings\u0026amp;title=Catalog\u0026amp;description=Return+your+events%2C+one+page+at+a+time\u0026amp;theme=ca1b6992667328742845d162\u0026amp;signature=b8152ce48e3263f323ba31b3a347a6e982e61a0914af7f4a7095bbdd9d3b8ff2\">\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/catalog\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/vendor-api/catalog.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/catalog#webpage\",\"url\":\"https://docs.gomry.com/vendor-api/catalog\",\"name\":\"Catalog\",\"description\":\"Return your events, one page at a time\",\"dateModified\":\"2026-10-01T12:48:00.182Z\",\"isPartOf\":{\"@id\":\"https://docs.gomry.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gomry.com/vendor-api/catalog#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gomry.com/vendor-api/catalog#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Gomry API\",\"item\":\"https://docs.gomry.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Catalog\",\"item\":\"https://docs.gomry.com/vendor-api/catalog\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gomry.com/vendor-api/catalog#apireference\",\"headline\":\"Catalog\",\"name\":\"Catalog\",\"description\":\"Return your events, one page at a time\",\"url\":\"https://docs.gomry.com/vendor-api/catalog\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gomry.com/vendor-api/catalog#webpage\"},\"dateModified\":\"2026-10-01T12:48:00.182Z\",\"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/catalog.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","description":"What you and Gomry exchange to connect a supplier, and what to verify before inventory reaches buyers","href":"/vendor-api/going-live"}]},{"group":"Catalog and Listings","pages":[{"title":"Catalog","api":"GET https://integration.example.com/api/vendor/v1/catalog","playground":"none","href":"/vendor-api/catalog"},{"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"},{"title":"Venue Map","api":"GET https://integration.example.com/api/vendor/v1/venue-map","playground":"none","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":"Catalog - 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"]}