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

# Mappings

`GET /v3/api/mappings`

## 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/fastapi.md) · [All operations](https://skmtc.dev/monarchinitiative/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monarchinitiative/fastapi/revisions/2ceb106a8c03/schema)