---
title: "Identity By External"
method: GET
path: "/v1/identity/{provider}/by-external/{external_id}"
tags: ["identity"]
---

# Identity By External

`GET /v1/identity/{provider}/by-external/{external_id}`

## Request

- Base URL: `https://api.monni.fyi` (the document declares no server; this is the origin it was published from)
- URL: `https://api.monni.fyi/v1/identity/{provider}/by-external/{external_id}`
- Auth: API key in header `X-API-Key`

Reverse lookup: which member of the calling guild owns this external account.

## Path parameters

- `provider` 'roblox' | 'minecraft_java', required
- `external_id` string, required

## Response `200`

Successful Response

- ExternalIdentity
  - `provider` string, required
  - `external_id` string, required
  - `user_id` string, nullable

## Other responses

- `401`: Missing or invalid API key.
- `403`: The key lacks the required verification permission, or the guild has no active premium subscription.
- `422`: Validation Error
- `429`: Out of requests. `X-RateLimit-Bucket` says which limit you hit and `Retry-After` how many seconds to wait. This request was not counted against you.

## Changes

- **2026-09-24** `2ec565e413a7`: 3 warning, 1 info
  - the optional response header `X-RateLimit-Limit` removed for the status `200`
  - the optional response header `X-RateLimit-Remaining` removed for the status `200`
  - the optional response header `X-RateLimit-Reset` removed for the status `200`
  - added the media type `application/json` for the response with the status `429`
- **2026-09-16** `83ac8f547df8`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/monni/apis/monni-api/changes/v1/identity/:provider/by-external/:external_id/get.md)

---

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