---
title: "POST /v1/fingerprints"
method: POST
path: "/v1/fingerprints"
tags: ["Fingerprints"]
---

# POST /v1/fingerprints

`POST /v1/fingerprints`

Get mod files that match a list of fingerprints.

## Request body

- GetFingerprintMatchesRequestBody
  - `fingerprints` integer[]

## Response `200`

- GetFingerprintMatchesResponse
  - `data` FingerprintsMatchesResult
    - `isCacheBuilt` boolean
    - `exactMatches` FingerprintMatch[]
      - `id` integer
      - `file` File
        - `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
      - `latestFiles` File[]
        - `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
    - `exactFingerprints` integer[]
    - `partialMatches` FingerprintMatch[]
      - `id` integer
      - `file` File
        - `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
      - `latestFiles` File[]
        - `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
    - `partialMatchFingerprints` object
    - `installedFingerprints` integer[]
    - `unmatchedFingerprints` integer[]

## Other responses

- `400`
- `503`

---

[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)