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

# Get Votes

Get the authenticated user's vote on a specific upload.

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://fucksornot.com/api/vote?uploadId=550e8400-e29b-41d4-a716-446655440000" \
    -H "Cookie: auth-token=YOUR_JWT_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://fucksornot.com/api/vote?uploadId=550e8400-e29b-41d4-a716-446655440000', {
    credentials: 'include'
  });
  const { vote } = await response.json();
  ```
</CodeGroup>

## Parameters

| Parameter  | Type | Required | Description                                     |
| ---------- | ---- | -------- | ----------------------------------------------- |
| `uploadId` | UUID | Yes      | The upload to check the current user's vote for |

<Note>
  `uploadId` is required. If it's missing, the request returns a `400` error with the message `"Upload ID required"`.
</Note>

## Response

```json theme={null}
{
  "vote": "fucks"
}
```

If the authenticated user has not voted on this upload, `vote` is `null`:

```json theme={null}
{
  "vote": null
}
```

## Response Fields

| Field  | Type           | Description                                                                 |
| ------ | -------------- | --------------------------------------------------------------------------- |
| `vote` | string \| null | `fucks`, `does_not_fuck`, or `null` if the user hasn't voted on this upload |

## Use Cases

* Check whether the current user has already voted on an upload
* Display the user's existing vote state in the UI
* Prevent duplicate vote attempts before submitting