---
title: "Mappings"
method: GET
path: "/v3/api/mappings"
tags: ["search"]
---

# Mappings

`GET /v3/api/mappings`

## Request

- Base URL: `https://monarchinitiative.org` (the document declares no server; this is the origin it was published from)
- URL: `https://monarchinitiative.org/v3/api/mappings`
- Auth: none declared

## Query parameters

- `entity_id` string[], nullable
- `subject_id` string[], nullable
- `predicate_id` MappingPredicate[], nullable
- `object_id` string[], nullable
- `mapping_justification` string[], nullable
- `format` 'json' | 'tsv'
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- MappingResults: SSSOM Mappings returned as a results collection
  - `limit` integer, required: number of items to return in a response
  - `offset` integer, required: offset into the total number of items
  - `total` integer, required: total number of items matching a query
  - `items` Mapping[], required: A collection of items, with the type to be overriden by slot_usage
    - `subject_id` string, required
    - `subject_label` string, nullable: The name of the subject entity
    - `predicate_id` string, required
    - `object_id` string, required
    - `object_label` string, nullable: The name of the object entity
    - `mapping_justification` string, nullable
    - `id` string, required

## Other responses

- `404`: Not Found
- `422`: Validation Error

---

[API](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api.md) - [All operations](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/revisions/00871419e83e?raw)