> ## 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 vote

> Polls that hide their votes only return the own votes of the requesting user, or any vote with admin access. For polls with `vote_per_day` only the votes of the current day are found.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/polls/{poll_id}/votes/{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}/votes/{id}:
    parameters:
      - name: poll_id
        in: path
        description: Poll member_hash or admin_hash
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: Vote id
        required: true
        schema:
          type: string
      - 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:
        - Votes
      summary: Get vote
      description: >-
        Polls that hide their votes only return the own votes of the requesting
        user, or any vote with admin access. For polls with `vote_per_day` only
        the votes of the current day are found.
      parameters:
        - name: X-POLLUNIT-USER-IDENTIFIER
          in: header
          required: false
          description: >-
            Your own identification of the user on whose behalf the request is
            made, any string. The user identifiers should not be guessable and
            stay secret, otherwise users could get access to other users'
            contents. Only used with a public API token: the created or changed
            object belongs to that anonymous user instead of the token owner,
            which keeps the user in control of it in later requests with the
            same identifier.
          schema:
            type: string
        - name: X-POLLUNIT-POLL-PASSWORD
          in: header
          required: false
          description: >-
            Access password of the poll. Only needed for password protected
            polls.
          schema:
            type: string
      responses:
        '200':
          description: vote found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Vote'
        '401':
          description: unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized'
        '403':
          description: poll hides the votes of other participants
        '404':
          description: vote not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
      security:
        - bearerAuth: []
components:
  schemas:
    Vote:
      type: object
      description: >-
        A vote of one participant for one option. Which value field is set
        depends on the poll's `vote_type`.
      properties:
        id:
          type: string
          description: Vote id
        type:
          type: string
          example: Votes::RatingVote
        created_at:
          type: string
          format: date-time
          nullable: true
        updated_at:
          type: string
          format: date-time
          nullable: true
        option_id:
          type: string
          nullable: true
          description: >-
            Option public_id. For pairwise comparisons the option that won the
            comparison.
        loser_option_id:
          type: string
          nullable: true
          description: >-
            Pairwise comparisons only: option public_id of the option that lost
            the comparison.
        voter_id:
          type: string
          nullable: true
          description: Voter public_id
        vote:
          anyOf:
            - type: number
              nullable: true
            - type: string
              nullable: true
          description: >-
            The value of the vote, whichever of `vote`, `vote_date`, `vote_text`
            or the decimal value is set.
        vote_date:
          type: string
          format: date
          nullable: true
          description: Day the vote was cast on, for polls with `vote_per_day`.
        vote_text:
          type: string
          nullable: true
          description: Value of text votes, e.g. table columns.
        paid:
          type: boolean
          nullable: true
          description: >-
            Admin access only, and only for polls with a voting wallet. `false`
            while bought votes are not paid yet.
        voting_category_id:
          type: integer
          nullable: true
          description: Only for polls with `voting_categories`.
      required:
        - id
        - type
    Unauthorized:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
    NotFound:
      type: object
      properties:
        error:
          type: string
          example: Not Found
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: Personal API token — find yours under My Account → API.

````