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

# POST /_matrix/identity/v2/lookup

`POST /_matrix/identity/v2/lookup`

Extends https://spec.matrix.org/v1.6/identity-service-api/#post_matrixidentityv2lookup to display inactive users and 3PID users

## Request body

- object
  - `addresses` string[], required
  - `algorithm` string, required — Algorithm the client is using to encode the addresses
  - `pepper` string, required — Pepper from '/hash_details'

## Response `200`

Success

- object
  - `mappings` object — List of active accounts
  - `inactive_mappings` object — List of inactive accounts
  - `third_party_mappings` object — List of hashed addresses by identity server hostname
    - `hostname` object
      - `actives` string[]
      - `inactives` string[]

## 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/lookup/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)