---
title: "POST /v1/mods/files"
method: POST
path: "/v1/mods/files"
tags: ["Files"]
---

# POST /v1/mods/files

`POST /v1/mods/files`

Get a list of files.

## Request body

- GetModFilesRequestBody
  - `fileIds` integer[]

## Response `200`

- GetFilesResponse
  - `data` File[] — The response data
    - `id` integer — The file id
    - `gameId` integer — The game id related to the mod that this file belongs to
    - `modId` integer — The mod id
    - `isAvailable` boolean — Whether the file is available to download
    - `displayName` string — Display name of the file
    - `fileName` string — Exact file name
    - `releaseType` 1 | 2 | 3 — 1 = Release 2 = Beta 3 = Alpha
    - `fileStatus` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 — 1 = Processing 2 = ChangesRequired 3 = UnderReview 4 = Approved 5 = Rejected 6 = MalwareDetected 7 = Deleted 8 = Archived 9 = Testing 10 = Released 11 = ReadyForReview 12 = Deprecated 13 = Baking 14 = AwaitingPublishing 15 = FailedPublishing
    - `hashes` FileHash[] — The file hash (i.e. md5 or sha1)
      - `value` string
      - `algo` 1 | 2 — 1 = Sha1 2 = Md5
    - `fileDate` string, date-time — The file timestamp
    - `fileLength` integer — The file length in bytes
    - `downloadCount` integer — The number of downloads for the file
    - `fileSizeOnDisk` integer, nullable — The file's size on disk
    - `downloadUrl` string — The file download URL
    - `gameVersions` string[] — List of game versions this file is relevant for
    - `sortableGameVersions` SortableGameVersion[] — Metadata used for sorting by game versions
      - `gameVersionName` string — Original version name (e.g. 1.5b)
      - `gameVersionPadded` string — Used for sorting (e.g. 0000000001.0000000005)
      - `gameVersion` string — game version clean name (e.g. 1.5)
      - `gameVersionReleaseDate` string, date-time — Game version release date
      - `gameVersionTypeId` integer, nullable — Game version type id
    - `dependencies` FileDependency[] — List of dependencies files
      - `modId` integer
      - `relationType` 1 | 2 | 3 | 4 | 5 | 6 — 1 = EmbeddedLibrary 2 = OptionalDependency 3 = RequiredDependency 4 = Tool 5 = Incompatible 6 = Include
    - `exposeAsAlternative` boolean, nullable
    - `parentProjectFileId` integer, nullable
    - `alternateFileId` integer, nullable
    - `isServerPack` boolean, nullable
    - `serverPackFileId` integer, nullable
    - `isEarlyAccessContent` boolean, nullable
    - `earlyAccessEndDate` string, date-time, nullable
    - `fileFingerprint` integer
    - `modules` FileModule[]
      - `name` string
      - `fingerprint` integer
    - `cookingInfo` CookerInfo
      - `cookerVersion` string
      - `cookerRevision` string

## Other responses

- `400`
- `404`
- `500`

---

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