---
title: "Gets the current state and all history for a given mapping rule a given namespace"
method: GET
path: "/namespaces/{namespaceID}/mapping-rules/{ruleID}/history"
tags: ["mapping-rules"]
---

# Gets the current state and all history for a given mapping rule a given namespace

`GET /namespaces/{namespaceID}/mapping-rules/{ruleID}/history`

## Path parameters

- `namespaceID` string, required
- `ruleID` string, required

## Query parameters

- `limit` string, required
- `page` string, required

## Response `200`

rule state sorted latest first

- MappingRule[]
  - `id` string
  - `name` string
  - `filter` string
  - `aggregation` string[]
  - `storagePolicies` string[]
  - `dropPolicy` integer
  - `cutoverMillis` integer
  - `lastUpdatedBy` string
  - `lastUpdatedAtMillis` integer

## Other responses

- `404` — no such namespace or no such rule
- `500` — Something went horribly wrong

## Changes

- **2018-04-26** (v1) `6ae596c30256` — 1 breaking, 1 warning
  - added the new path request parameter `ruleID`
  - deleted the `path` request parameter `ruleId`
- **2017-09-27** (v1) `f759242dbb8a` — 1 breaking, 1 warning
  - added the new path request parameter `ruleId`
  - deleted the `path` request parameter `ruleID`

[Change history](https://skmtc.dev/m3db/apis/r2-api/changes/namespaces/:namespaceID/mapping-rules/:ruleID/history/get.md)

---

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