---
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` — Not Found
- `405` — Unrecognized
- `500` — Internal server error

---

[API](https://skmtc.net/linagora/apis/twake-on-matrix-apis-documentation.md) · [All operations](https://skmtc.net/linagora/apis/twake-on-matrix-apis-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linagora/twake-on-matrix-apis-documentation/revisions/3428c7bb5a46/schema)