> ## Documentation Index
> Fetch the complete documentation index at: https://partner.headout.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Venue Map

Returns a CDN URL for the venue layout SVG. Used by products with `inventorySelectionType: SEATMAP` or `inventorySelectionType: SVG`.

The SVG is static per product — it does not change per show or date. Call this once per product and cache the result.

## Section mapping for SVG flow

For `inventorySelectionType: SVG` products, use the SVG to display the venue layout and map it to the sections available in the inventory response.

In the [Get Product](/docs/api-partner/v2/products/get) response, each section is mapped to a variant ID. The SVG has section elements with a class attribute in the format `tour-id-{variantId}`. Match the variant ID to the SVG element's `tour-id-{variantId}` class to identify and highlight the correct section.

Two class formats are supported — handle both for compatibility:

| Format       | Example                 |
| ------------ | ----------------------- |
| Bare numeric | `class="82330"`         |
| Prefixed     | `class="tour-id-82330"` |

## Venue layout for Seatmap flow

For `inventorySelectionType: SEATMAP` products, use the SVG to render the physical venue layout when building a custom seat selection UI. Each seat element in the SVG has an `id` attribute equal to the `seatCode` returned by [List Inventory - Seatmap](/docs/api-partner/v2/seatmap/inventory). Use the `seatCode` to match inventory seats to SVG elements for highlighting or disabling individual seats.

For example, a seat with `"seatCode": "SE-0.205-10-1"` in the inventory response corresponds to the SVG element with `id="SE-0.205-10-1"`.

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "productId": 3023,
    "svgUrl": "https://cdn.headout.com/seatmap/3314/venue-layout.svg"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/public/v2/products/{productId}/svg/
openapi: 3.1.0
info:
  title: Headout API Docs - API Partner v2
  version: 0.0.1
servers:
  - url: https://www.headout.com
    description: Production server
  - url: https://www.sandbox-headout.com
    description: Sandbox server
security: []
paths:
  /api/public/v2/products/{productId}/svg/:
    get:
      tags:
        - Seatmap
      summary: Venue map
      operationId: getSeatmapSvg
      parameters:
        - name: productId
          in: path
          required: true
          schema:
            type: integer
          description: Product identifier
      responses:
        '200':
          description: SVG URL for the venue layout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SeatmapSvgResponse'
        '403':
          description: Partner not authorised, or partner type is Affiliate
        '404':
          description: No SVG available for this product
      security:
        - apiKeyAuth: []
components:
  schemas:
    SeatmapSvgResponse:
      type: object
      properties:
        productId:
          type: integer
        svgUrl:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Headout-Auth

````