---
title: "Gets saves from a collection."
method: GET
path: "/toolbox-service/v1/saves"
tags: ["Creator Store"]
---

# Gets saves from a collection.

`GET /toolbox-service/v1/saves`

## Query parameters

- `targetType` 'Audio' | 'Model' | 'Decal' | 'Plugin' | 'MeshPart' | 'Video' | 'FontFamily' — This represents a "subset" of Toolbox.Service.CategoryType options and represent the full set of "categories" (or asset types) that can be searched upon from the toolbox search API.
- `targetId` integer, nullable
- `collectionName` string
- `sortBy` 'Name' | 'Creator' | 'Ratings' | 'TargetType' | 'DateSaved' | 'LastModified' | 'Price' — The category to sort the saves by.
- `sortDirection` 'None' | 'Ascending' | 'Descending' — Represents the direction in which to sort the results
- `limit` integer
- `page` integer
- `keyword` string
- `hideOwnedAssets` boolean

## Response `200`

Success

- GetSavesResponse, nullable — Response model for getting saves
  - `totalCount` integer, required — The total number of saves that match the query.
  - `saves` HydratedSave[], nullable, required — Gets or sets the saves.
    - `owned` boolean — Whether the asset is owned by the user.
    - `dateSaved` string, date-time — Date the save was added.
    - `creatorStoreAsset` CreatorStoreAsset, nullable — Representation of a creator store asset.
      - `voting` VotingModel, nullable — model for voting.
        - `showVotes` boolean — Gets or sets show votes.
        - `upVotes` integer — Gets or sets success.
        - `downVotes` integer — Gets or sets down votes.
        - `canVote` boolean — Gets or sets can vote.
        - `userVote` boolean, nullable — Gets or sets user vote.
        - `hasVoted` boolean — Gets UserVote.
        - `voteCount` integer — The total number of votes
        - `upVotePercent` integer — The percentage of total votes that have been UpVotes
      - `creator` CreatorModelV2, nullable — Model representing a creator.
        - `creator` string, nullable — Deprecated: Please refer to the 'userId' and 'groupId' properties instead. The creator type and ID. E.g. user/123 or group/456.
        - `userId` integer, nullable — The User ID of the creator. Required if the asset is individual-user-owned.
        - `groupId` integer, nullable — The Group ID. Required if the asset is group-owned.
        - `name` string, nullable — The creator's name.
        - `verified` boolean, nullable — Whether the creator is verified.
        - `latestGroupUpdaterUserId` integer, nullable — This value only exists for group-based creators and represents the User ID of the creator who most recently updated the asset.
        - `latestGroupUpdaterUserName` string, nullable — This value only exists for group-based creators and represents the name of the creator who most recently updated the asset.
      - `creatorStoreProduct` ToolboxServiceCreatorStoreProduct, nullable — The asset's creator store product information.
        - `purchasePrice` ToolboxServiceMoney, nullable
          - `currencyCode` string, nullable
          - `quantity` ToolboxServiceDecimal, nullable
            - `significand` integer
            - `exponent` integer
        - `purchasable` boolean — Whether or not the asset can be purchased in the Creator Store.
      - `asset` union — The asset information.
        - ToolboxServiceAsset, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"
        - Audio, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"
        - Decal, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"
        - MeshPart, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"
        - Model, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"
        - Music, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"
        - Plugin, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"
        - SoundEffect, nullable — Representation of an asset.
          - `id` integer — The unique identifier of the asset.
          - `name` string, nullable — The name of the asset.
          - `description` string, nullable — The description of the asset.
          - `assetTypeId` integer, nullable — The type that the asset belongs to.
          - `socialLinks` SocialLinkModel[], nullable — The social links associated with the asset.
            - `linkType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
            - `url` string, nullable — Gets or sets the Url.
            - `title` string, nullable — Gets or sets the title.
          - `previewAssets` PreviewAssetsModel, nullable — Grouped preview asset ids for an item, separated by media type.
            - `imagePreviewAssets` integer[], nullable — Ordered list of image preview asset ids.
            - `videoPreviewAssets` integer[], nullable — Ordered list of video preview asset ids.
          - `createTime` string, date-time, nullable — The time the asset was created.
          - `updateTime` string, date-time, nullable — The time the asset was last updated.
          - `creatingUniverseId` integer, nullable — Universe ID if the asset was created within a specific universe.
          - `categoryPath` string, nullable — Category Path of the asset, if it exists. e.g. "3d__characters"

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/revisions/958b2b40425d/schema)