---
title: "Details and a download link for a file."
method: GET
path: "/api/v1/user/file/{objectKey}"
tags: ["user"]
---

# Details and a download link for a file.

`GET /api/v1/user/file/{objectKey}`

## Path parameters

- `objectKey` string, required

## Response `200`

Found file.

- FileWIthUrlDTO — Details on a file that has been uploaded for auto-tagging or audio-recognition purposes. including download path.
  - `file` FileDTO, required — Details on a file that has been uploaded for auto-tagging or audio-recognition purposes.
    - `id` integer, required
    - `name` string, required
    - `objectKey` string, required
    - `folder` string, required
    - `extension` 'mp3' | 'wav' | 'flac', required — extension of the file
    - `url` string
    - `uploadStartTime` string, date-time
    - `uploadEndTime` string, date-time
    - `fingerprintStatus` 'processing' | 'error' | 'found' | 'not_found' | 'not_started' — status of the audio recognition
    - `fingerprintStartTime` string, date-time
    - `fingerprintEndTime` string, date-time
    - `inferenceStatus` 'processing' | 'error' | 'done' | 'not_started' — status of the auto-tagging
    - `inferenceStartTime` string, date-time
    - `inferenceEndTime` string, date-time
    - `recording` RecordingMediumBaseDTO
      - `titles` TitleDTO[]
        - `titleText` string, required
      - `tracks` TrackDTO[]
        - `songtradrTrackId` string
      - `isrc` string, required
      - `genres` GenreDTO[]
        - `id` integer, required
        - `name` string, required
      - `recordingPartyEntities` RecordingPartyDTO[]
        - `party` PartySmallDTO, required — Party (person, group or organization) with a small field-set.
          - `id` string, required
          - `fullName` string, required
        - `contributorTypes` ContributorTypeDTO[]
          - `typeName` string, required
      - `spotifyId` string
      - `releaseDate` string, date-time
      - `languageOfPerformance` string
      - `tags` RecordingTagSmallDTO[]
        - `tag` TagDTO, required — A tag for recordings.
          - `id` integer, required
          - `name` string, required
          - `categories` CategoryMinimalDTO[]
            - `categoryName` string, required
      - `inferenceUpdatedAt` string, date-time
    - `error_time` string, date-time
    - `error_message` string
  - `url` string, required

## Other responses

- `400` — File not found with this objectKey.
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/songtradr/apis/songtradr-api.md) · [All operations](https://skmtc.net/songtradr/apis/songtradr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songtradr/songtradr-api/versions/84accaa11469/schema)