---
title: "POST /_matrix/identity/v2/lookups"
method: POST
path: "/_matrix/identity/v2/lookups"
tags: ["Federated identity service"]
---

# POST /_matrix/identity/v2/lookups

`POST /_matrix/identity/v2/lookups`

Implements https://github.com/guimard/matrix-spec-proposals/blob/unified-identity-service/proposals/4004-unified-identity-service-view.md

## Request body

- object
  - `mappings` object — List of hashed addresses by identity server hostname
    - `hostname` object[]
      - `hash` string
      - `active` number
  - `algorithm` string, required — Algorithm the client is using to encode the addresses
  - `pepper` string, required — Pepper from '/hash_details'

## Response `201`

Success

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Private note not found
- `405` — Unrecognized
- `500` — Internal server error

## Changes

- **2024-06-06** `ecce38b281bc` — 2 info
  - api tag `Federated identity service` added
  - api tag `Federation server` removed
- **2024-01-09** `c7a6d3a400a7` — 2 info
  - api tag `Federation server` added
  - api tag `Federated identity service` removed

[Change history](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/changes/_matrix/identity/v2/lookups/post.md)

---

[API](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation.md) · [All operations](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/linagora/apis/twake-on-matrix-apis-documentation/revisions/ecce38b281bc?raw)