---
title: "Gets a list of a user's third-party identifiers."
method: GET
path: "/_matrix/client/v3/account/3pid"
tags: ["Account management"]
---

# Gets a list of a user's third-party identifiers.

`GET /_matrix/client/v3/account/3pid`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v3/account/3pid`
- Auth: one of:
  - API key in query parameter `access_token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v3/account/3pid/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets a list of the third-party identifiers that the homeserver has
associated with the user's account.

This is *not* the same as the list of third-party identifiers bound to
the user's Matrix ID in identity servers.

Identifiers in this list may be used by the homeserver as, for example,
identifiers that it will accept to reset the user's account password.

## Response `200`

The lookup was successful.

- object
  - `threepids` object[]
    - `added_at` integer, required: The timestamp, in milliseconds, when the homeserver associated the third-party identifier with the user.
    - `address` string, required: The third-party identifier address.
    - `medium` 'email' | 'msisdn', required: The medium of the third-party identifier.
    - `validated_at` integer, required: The timestamp, in milliseconds, when the identifier was validated by the identity server.

---

[API](https://skmtc.dev/matrix/apis/matrix-client-server-api.md) - [All operations](https://skmtc.dev/matrix/apis/matrix-client-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/matrix/apis/matrix-client-server-api/revisions/c7fe4072c681?raw)