Skip to main content
Retrieve details for a specific upload.

​
Request

Public uploads can be fetched without authentication. To access a private upload, include your auth-token cookie — only the owner or an admin can view it. 
curl https://fucksornot.com/api/upload/550e8400-e29b-41d4-a716-446655440000

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "user_id": "user-uuid",
  "filename": "abc123.webp",
  "original_name": "myimage.jpg",
  "description": "Check out this cool gadget",
  "upload_type": "image",
  "external_url": null,
  "upvotes": 42,
  "downvote_count": 5,
  "is_private": 0,
  "created_at": "2025-01-24T12:00:00Z",
  "tags": [
    {
      "id": "tag-uuid",
      "name": "gadget",
      "slug": "gadget"
    }
  ],
  "username": "johndoe",
  "stats": {
    "voteCount": 47,
    "upvotes": 42,
    "downvotes": 5,
    "averageRating": 7.468085106382978
  }
}

​
Fields

FieldTypeDescription
idUUIDUnique identifier
user_idUUIDOwner’s user ID
filenamestringStored filename (null for links)
original_namestringOriginal filename
descriptionstringUser-provided description
upload_typestringimage or link
external_urlstringURL for links
upvotesinteger”Fucks” vote count
downvote_countinteger”Does not fuck” vote count
is_privateinteger0 = public, 1 = private
created_attimestampCreation time
tagsarrayAssociated tags
usernamestringUploader’s username
statsobjectComputed vote statistics, always present
stats.voteCountintegerTotal number of votes (upvotes + downvotes)
stats.upvotesinteger”Fucks” vote count
stats.downvotesinteger”Does not fuck” vote count
stats.averageRatingnumber | nullWeighted average rating (upvotes weighted toward 10, downvotes toward 1); null if there are no votes

​
Access Control

  • Public uploads are accessible without authentication
  • Private uploads return 404 unless you’re the owner or an admin

​
Errors

StatusDescription
404Upload not found or not accessible