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

# Get ticket rate by id

> Get ticket rate by id



## OpenAPI

````yaml get /ticket-rates/{id}
openapi: 3.0.0
info:
  title: Channel Manager API
  version: 0.1.0
  description: >-
    Official API documentation for Channel Manager. All endpoints are protected
    by an API key.
servers:
  - url: https://channels-service-alpha.fourvenues.com
    description: Test server
  - url: https://channels-service.fourvenues.com
    description: Production server
security: []
tags: []
paths:
  /ticket-rates/{id}:
    get:
      tags:
        - TicketRates
      summary: Get ticket rate by id
      description: Get ticket rate by id
      operationId: getTicketRateById
      parameters:
        - name: id
          in: path
          description: Ticket rate id
          required: true
          schema:
            example: abcde12345
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/TicketRate'
                  success:
                    type: boolean
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '404':
          description: Not Found
      security:
        - ApiKey: []
components:
  schemas:
    TicketRate:
      type: object
      properties:
        _id:
          type: string
          example: abcdefghi1234567890
          description: Ticket rate unique identifier.
        organization_id:
          type: string
          example: abcdefghi1234567890
          description: Ticket rate organization unique identifier.
        event_id:
          type: string
          example: abcdefghi1234567890
          description: Event unique identifier.
        name:
          type: string
          example: General Access
          description: Name of the ticket rate.
        slug:
          type: string
          example: general-access
          description: Name URL-friendly identifier.
        valid_from:
          type: string
          example: '2022-01-01T00:00:00.000Z'
          description: Date when the ticket rate will be available for sale.
        complete:
          type: boolean
          example: false
          description: If the ticket rate is marked as complete.
        type:
          type: string
          example: limited
          enum:
            - limited
            - public
        show_all_prices:
          type: boolean
          example: true
          description: If the ticket rate is configured to show all prices.
        prices:
          type: array
          items:
            $ref: '#/components/schemas/PriceTicketRate'
          description: Prices of the ticket rate.
        supplements:
          type: array
          items:
            $ref: '#/components/schemas/Supplement'
          description: >-
            Optional add-ons for this ticket rate. Paid supplements increase the
            ticket price; free supplements (price 0) are added automatically
            when omitted from checkout. Purchase limits apply at checkout
            (duplicate supplement_id entries are collapsed first).
            redemption_deadline is stored on the ticket for redemption at the
            event, not validated at purchase time.
        available:
          type: boolean
          example: true
          description: If the ticket rate is available.
        current_price:
          $ref: '#/components/schemas/PriceTicketRate'
          description: Current price available of the ticket rate.
        warranty:
          type: object
          properties:
            enabled:
              type: boolean
              example: true
              description: If the warranty is enabled.
            percentage:
              type: number
              example: 20
              description: >-
                Cost of the warranty (applying the percentage to the final price
                of the ticket).
            hours:
              type: number
              example: 12
              description: Hours before the event the warranty can be used.
        availability:
          type: object
          properties:
            sold:
              type: number
              example: 10
              description: Number of tickets sold by the channel.
            available:
              type: number
              example: 90
              description: Number of tickets available to buy.
        min:
          type: number
          example: 1
          description: Minimum number of tickets that can be purchased in a single order.
        max:
          type: number
          example: 10
          description: Maximum number of tickets that can be purchased in a single order.
        questions:
          type: array
          items:
            $ref: '#/components/schemas/Question'
          description: Questions of the ticket rate.
        has_discount_codes_enabled:
          type: boolean
          example: true
          description: Wether there is any discount code enabled for this ticket rate
      required:
        - id
        - organization_id
        - event_id
        - name
        - slug
        - valid_from
        - complete
        - type
        - prices
        - supplements
        - min
        - max
        - available
        - availability
        - questions
    PriceTicketRate:
      type: object
      description: >-
        A ticket rate can have one or multiple prices but only one can be active
        at a time.
      properties:
        _id:
          type: string
          example: '1643064796675'
          description: Unique identifier for the price.
        name:
          type: string
          example: Early Bird
          description: Name of the price.
        price:
          type: number
          example: 12
          description: Price of the ticket.
        valid_until:
          type: string
          example: '2022-01-01T00:00:00.000Z'
          description: Date until the price will be available.
        quantity:
          type: number
          example: 0
          description: >-
            Max number of tickets that can be purchased with this price. NOTE: 0
            means unlimited.
        fee_type:
          type: string
          example: percentage
          enum:
            - percentage
            - fixed
          description: Type of the fee.
        fee_quantity:
          type: number
          example: 10
          description: Quantity of the fee.
        includes:
          type: string
          example: 1 Drink
          description: Content the price includes.
        additional_info:
          type: string
          example: Only valid before 2:00 am.
          description: Additional info.
        used:
          type: number
          example: '55'
          description: Number of tickets sold of this price
      required:
        - id
        - price
        - valid_until
        - quantity
        - includes
        - additional_info
    Supplement:
      type: object
      description: Ticket rate supplement (add-on) configuration.
      properties:
        _id:
          type: string
          example: '1643064796675'
          description: Unique identifier for the supplement.
        label:
          type: string
          example: 1 Copa
          description: Display label of the supplement.
        price:
          type: number
          example: 12
          description: >-
            Unit price per supplement pack. When 0, the supplement is free (one
            pack is added per ticket with purchase_quantity 1).
        has_fake_price:
          type: boolean
          example: true
          description: >-
            When true, fake_price is shown as the original price before
            discount.
        fake_price:
          type: number
          example: 15
          description: Original price shown to the customer when has_fake_price is true.
        description:
          type: string
          example: Includes one drink at the bar
          description: Longer description of the supplement.
        product_quantity:
          type: number
          example: 4
          description: >-
            Redeemable items per purchased pack (e.g. 4 drinks inside each
            pack). On the ticket, purchase_quantity is how many packs were
            bought and product_quantity is copied from the rate.
        purchase_limit:
          $ref: '#/components/schemas/SupplementPurchaseLimit'
        redemption_deadline:
          $ref: '#/components/schemas/SupplementRedemptionDeadline'
        service_charge_amount:
          type: number
          example: 15
          description: >-
            Service charge amount. Interpreted as a fixed amount or percentage
            depending on service_charge_type.
        service_charge_type:
          type: string
          enum:
            - fixed
            - percentage
          example: percentage
          description: How service_charge_amount is applied to the supplement unit price.
    Question:
      type: object
      properties:
        _id:
          type: string
          example: '1643064796675'
          description: Unique identifier for the question.
        label:
          type: string
          example: ¿How did you hear about us?
          description: Label of the question.
        type:
          type: string
          example: dropdown
          enum:
            - text
            - dropdown
        required:
          type: boolean
          example: true
          description: If the question is required.
        items:
          type: array
          items:
            type: string
          description: Options of the question.
          example:
            - Instagram
            - Appear
      required:
        - _id
        - label
        - type
        - required
    SupplementPurchaseLimit:
      type: object
      description: Quantity constraints applied when purchasing a paid supplement.
      properties:
        min_quantity:
          type: number
          example: 2
          description: >-
            Minimum units that must be purchased when this supplement is
            selected.
        max_quantity:
          type: number
          example: 8
          description: Maximum units allowed per ticket when is_unlimited is false.
        is_unlimited:
          type: boolean
          example: false
          description: When true, max_quantity is ignored.
    SupplementRedemptionDeadline:
      type: object
      description: >-
        Redemption window for the supplement at the event. Copied to the ticket
        as redemption_deadline_value; not enforced during checkout or ticket
        creation.
      properties:
        is_expiration_enabled:
          type: boolean
          example: true
          description: Whether expiration_deadline is enforced.
        expiration_deadline:
          type: number
          example: 1798851600
          description: >-
            Unix timestamp (seconds) after which the supplement cannot be
            purchased.
  securitySchemes:
    ApiKey:
      in: header
      name: X-Api-Key
      type: apiKey

````