---
title: "Get specific data-map inside a contract"
method: POST
path: "/v2/map_entry/{contract_address}/{contract_name}/{map_name}"
tags: ["Smart Contracts"]
---

# Get specific data-map inside a contract

`POST /v2/map_entry/{contract_address}/{contract_name}/{map_name}`

Attempt to fetch data from a contract data map. The contract is identified with [Stacks Address] and [Contract Name] in the URL path. The map is identified with [Map Name].

The key to lookup in the map is supplied via the POST body. This should be supplied as the hex string serialization of the key (which should be a Clarity value). Note, this is a JSON string atom.

In the response, `data` is the hex serialization of the map response. Note that map responses are Clarity option types, for non-existent values, this is a serialized none, and for all other responses, it is a serialized (some ...) object.

## Path parameters

- `contract_address` string, required
- `contract_name` string, required
- `map_name` string, required

## Query parameters

- `proof` integer
- `tip` string

## Request body

- string

## Response `200`

Success

- GetContractDataMapEntrySchemaJson — unresolved $ref

## Other responses

- `400` — Failed loading data map

## Changes

- **2021-12-01** `09258b775c7a` — 1 warning
  - deleted the `query` request parameter `use_latest_tip`
- **2021-11-17** `f936683f3e46` — 1 info
  - added the new optional `query` request parameter `use_latest_tip`
- **2021-10-13** `aef805fa1fb4` — 1 warning
  - deleted the `query` request parameter `use_latest_tip`
- **2021-09-27** `f35935b8996d` — 1 breaking
  - added required request body
- **2021-07-29** `40964fcc538a` — 1 breaking
  - for the `query` request parameter `use_latest_tip`, the type/format was changed from `string`/`` to `boolean`/``

[Full history](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api/changes/v2/map_entry/:contract_address/:contract_name/:map_name/post.md)

---

[API](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api.md) · [All operations](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hirosystems/stacks-2-0-rpc-api/revisions/7a7617c2d7cc/schema)