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

# Get option



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/polls/{poll_id}/options/{id}
openapi: 3.0.1
info:
  title: PollUnit API
  version: v1
  description: Programmatic access to PollUnit.
servers:
  - url: https://pollunit.com
    description: Production
  - url: http://localhost:3000
    description: Development
security:
  - bearerAuth: []
paths:
  /api/v1/polls/{poll_id}/options/{id}:
    parameters:
      - name: poll_id
        in: path
        description: Poll member_hash or admin_hash
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: Option id
        required: true
        schema:
          type: integer
      - name: organization_id
        in: query
        required: false
        description: >-
          public_id of an organization the user belongs to. When given, the
          request runs in that organization context instead of the personal
          account.
        schema:
          type: string
    get:
      tags:
        - Options
      summary: Get option
      responses:
        '200':
          description: option found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Option'
        '401':
          description: unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized'
        '404':
          description: option not found
      security:
        - bearerAuth: []
components:
  schemas:
    Option:
      type: object
      description: >-
        Full representation of a single poll option. Top-level fields vary by
        option type and are included conditionally depending on the poll's
        visibility settings and your access level (admin vs. member);
        type-specific configuration is grouped under `settings`.
      properties:
        id:
          type: string
          description: Option public_id
        admin_url:
          type: string
          format: uri
          nullable: true
          description: Admin access only
        public_url:
          type: string
          format: uri
        type:
          type: string
          description: Option STI class
          example: Options::TextOption
        content:
          type: string
          nullable: true
        subtitle:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        author_name:
          type: string
          nullable: true
        position:
          type: integer
          nullable: true
        state:
          type: string
          nullable: true
        rank:
          type: integer
          nullable: true
        rating:
          type: number
          format: float
          nullable: true
        average_rating:
          type: number
          format: float
          nullable: true
        best_rating:
          type: boolean
          nullable: true
        selected:
          type: boolean
          nullable: true
        child_option_type:
          type: string
          nullable: true
        data:
          type: object
          nullable: true
          description: >-
            Option-type-specific payload (e.g. location_data for location
            options)
        drawing_type:
          type: string
          nullable: true
          enum:
            - free_sketch
            - sign
            - draw_on_image
        input_type:
          type: string
          nullable: true
        location_type:
          type: string
          nullable: true
          enum:
            - point
            - route
            - polygon
            - circle
            - rectangle
        options_count:
          type: integer
          nullable: true
        paid:
          type: boolean
          nullable: true
        privacy_policy_accepted:
          type: boolean
          nullable: true
        processing:
          type: boolean
          nullable: true
        rotation:
          type: integer
          nullable: true
        terms_accepted:
          type: boolean
          nullable: true
        info_link:
          type: string
          nullable: true
        info_link_title:
          type: string
          nullable: true
        start_date:
          type: string
          format: date-time
          nullable: true
        end_date:
          type: string
          format: date-time
          nullable: true
        created_at:
          type: string
          format: date-time
          nullable: true
        updated_at:
          type: string
          format: date-time
          nullable: true
        video_thumb_path:
          type: string
          nullable: true
        vimeo_id:
          type: string
          nullable: true
        youtube_id:
          type: string
          nullable: true
        voter_count:
          type: integer
          nullable: true
        settings:
          $ref: '#/components/schemas/OptionSettings'
        approval_state:
          type: string
          nullable: true
          description: Admin access only
          enum:
            - unreviewed
            - approved
            - disapproved
        approval_state_updated_at:
          type: string
          format: date-time
          nullable: true
          description: Admin access only
        archived:
          type: boolean
          nullable: true
          description: Admin access only
        fraudulent_count:
          type: integer
          nullable: true
          description: Admin access only
        state_change_message:
          type: string
          nullable: true
          description: Admin access only
      required:
        - id
        - type
        - public_url
    Unauthorized:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
    OptionSettings:
      type: object
      description: Option-type-specific configuration, grouped for readability.
      properties:
        allowed_values:
          type: array
          items:
            type: string
          nullable: true
        column_width:
          type: integer
          nullable: true
        dot_vote_icon:
          type: integer
          nullable: true
        mandatory:
          type: boolean
          nullable: true
        multiline:
          type: boolean
          nullable: true
        randomize_options:
          type: boolean
          nullable: true
        require_vote:
          type: boolean
          nullable: true
        show_as_list:
          type: boolean
          nullable: true
        survey_step_rating_method:
          type: integer
          nullable: true
          description: Survey steps only. 0 = average_by_voted, 1 = average_by_all_voters
        survey_step_type:
          type: string
          nullable: true
          enum:
            - info
            - entry
            - rating
            - choice
            - drawing
            - location
        survey_step_vote_limit_per_option:
          type: integer
          nullable: true
        survey_step_vote_limit_per_option_min:
          type: integer
          nullable: true
        survey_step_vote_limit_per_voter:
          type: integer
          nullable: true
        survey_step_vote_type:
          type: string
          nullable: true
        voter_limit:
          type: integer
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: Personal API token — find yours under My Account → API.

````