---
title: "List and search your own files."
method: GET
path: "/api/v1/user/files"
tags: ["user"]
---

# List and search your own files.

`GET /api/v1/user/files`

## Query parameters

- `ISRC` string
- `page` integer
- `size` integer
- `sort` string[]

## Response `200`

found files.

- FileListDTO — List of files.
  - `files` FileDTO[], required
    - `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
      - `isrc` string, required
      - `titles` TitleDTO[]
        - `titleText` string, required
      - `tracks` TrackDTO[]
        - `songtradrTrackId` string
      - `genres` GenreDTO[]
        - `id` integer, required
        - `name` 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
      - `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
    - `error_time` string, date-time
    - `error_message` string
  - `hasNextPage` boolean, required
  - `currentPageNumber` integer, required
  - `totalResults` integer, required

## Other responses

- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/songtradr/apis/songtradr-api.md) · [All operations](https://skmtc.dev/songtradr/apis/songtradr-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/songtradr/songtradr-api/revisions/31c6f2d1e9a4/schema)