---
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` — 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/versions/3428c7bb5a46/schema)