---
title: "Get BGM data"
method: GET
path: "/raw/{region}/bgm/{bgm_id}"
tags: ["raw"]
---

# Get BGM data

`GET /raw/{region}/bgm/{bgm_id}`

Get the BGM data from the given BGM ID

## Path parameters

- `region` 'JP' | 'NA' | 'CN' | 'KR' | 'TW', required — Region Enum
- `bgm_id` integer, required

## Response `200`

BGM Entity

- BgmEntity
  - `mstBgm` MstBgm, required
    - `id` integer, required
    - `fileName` string, required
    - `name` string, required
    - `priority` integer, required
    - `detail` string
    - `flag` integer, required
    - `shopId` integer, required
    - `logoId` integer, required
    - `script` string, nullable
    - `fileLocation` string, nullable
  - `mstBgmRelease` MstBgmRelease[], required
    - `targetIds` integer[], required
    - `vals` integer[], required
    - `bgmId` integer, required
    - `id` integer, required
    - `priority` integer, required
    - `type` integer, required
    - `condGroup` integer, required
    - `closedMessageId` integer, required
  - `mstClosedMessage` MstClosedMessage[], required
    - `id` integer, required
    - `message` string, required
    - `overwriteQuestName` string, nullable
    - `leftIndent` integer, nullable
    - `flag` integer, nullable
  - `mstShop` MstShop
    - `itemIds` integer[], required
    - `prices` integer[], required
    - `targetIds` integer[], required
    - `script` object, required
    - `anotherPayType` integer, nullable
    - `anotherItemIds` integer[], nullable
    - `useAnotherPayCommonReleaseId` integer, nullable
    - `freeShopCondId` integer, nullable
    - `freeShopCondMessage` string, nullable
    - `hideWarningMessageCondId` integer, nullable
    - `freeShopReleaseDate` integer, nullable
    - `id` integer, required
    - `baseShopId` integer, required
    - `eventId` integer, required
    - `slot` integer, required
    - `flag` integer, required
    - `priority` integer, required
    - `purchaseType` integer, required
    - `setNum` integer, required
    - `payType` integer, required
    - `shopType` integer, required
    - `limitNum` integer, required
    - `defaultLv` integer, required
    - `defaultLimitCount` integer, required
    - `name` string, required
    - `detail` string, required
    - `infoMessage` string, required
    - `warningMessage` string, required
    - `imageId` integer, required
    - `bgImageId` integer, required
    - `openedAt` integer, required
    - `closedAt` integer, required
  - `mstItem` MstItem
    - `individuality` integer[], required
    - `script` object, required
    - `eventId` integer
    - `eventGroupId` integer
    - `isPresent` boolean
    - `maxNum` integer
    - `id` integer, required
    - `name` string, required
    - `detail` string, required
    - `imageId` integer, required
    - `bgImageId` integer, required
    - `type` integer, required
    - `unit` string, required
    - `value` integer, required
    - `sellQp` integer, required
    - `isSell` boolean, required
    - `priority` integer, required
    - `dropPriority` integer, required
    - `startedAt` integer, required
    - `endedAt` integer, required
    - `useSkill` boolean
    - `useAppendSkill` boolean
    - `useAscension` boolean
    - `useCostume` boolean
    - `mstItemSelect` MstItemSelect[]
      - `itemId` integer, required
      - `idx` integer, required
      - `candidateGiftId` integer, required
      - `requireNum` integer, required
      - `detail` string, required
    - `mstGift` MstGift[]
      - `sort_id` integer
      - `id` integer, required
      - `type` integer, required
      - `objectId` integer, required
      - `priority` integer, required
      - `num` integer, required
      - `lv` integer, nullable
      - `limitCount` integer, nullable
    - `mstGiftAdd` MstGiftAdd[]
      - `priorGiftIconIds` integer[], required
      - `giftId` integer, required
      - `priority` integer, nullable
      - `condType` integer, required
      - `targetId` integer, required
      - `targetNum` integer, required
      - `priorGiftId` integer, required
      - `script` string, required

## Other responses

- `404` — Item not found
- `422` — Validation Error

---

[API](https://skmtc.dev/atlasacademy/apis/fgo-game-data-api.md) · [All operations](https://skmtc.dev/atlasacademy/apis/fgo-game-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atlasacademy/apis/fgo-game-data-api/revisions/188da1780d29?raw)
