---
title: "Get Drop Matrix"
method: GET
path: "/PenguinStats/api/v2/result/matrix"
tags: ["Result"]
---

# Get Drop Matrix

`GET /PenguinStats/api/v2/result/matrix`

## Query parameters

- `server` 'CN' | 'US' | 'JP' | 'KR', required
- `is_personal` boolean
- `show_closed_zones` boolean
- `category` 'all' | 'automated' | 'manual'
- `stageFilter` string[]
- `itemFilter` string[]

## Response `200`

Drop Matrix response

- V2DropMatrixQueryResult
  - `matrix` V2OneDropMatrixElement[]
    - `end` integer
    - `itemId` string
    - `quantity` integer
    - `stageId` string
    - `start` integer
    - `stdDev` number
    - `times` integer

## Other responses

- `500` — An unexpected error occurred

## Changes

- **2023-05-06** `234b883fc044` — 1 info
  - added the new optional `query` request parameter `category`
- **2022-03-09** `aadf4ef7ee07` — 2 info
  - the endpoint scheme security `PenguinIDAuth` was added to the API
  - endpoint reactivated
- **2022-02-27** `2222bc4bbebb` — 1 info
  - endpoint added
- **2021-12-02** `8a0f5cfc9d22` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/penguin-statistics/apis/penguin-statistics-api/changes/PenguinStats/api/v2/result/matrix/get.md)

---

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