---
title: "Look up a organization by wallet or email"
method: GET
path: "/orgs/v1/email"
tags: ["Billing"]
---

# Look up a organization by wallet or email

`GET /orgs/v1/email`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/orgs/v1/email`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - API key in header `x-admin-key`

Resolves a wallet (?wallet=0x..) or email (?email=..) to its organization, returning the canonical org_id plus balance/tier/lease. Provide exactly one. Auth: admin key, or a SIWX header signed by ?wallet (email lookups are admin-only).

## Query parameters

- `wallet` string
- `email` string, email

## Response `200`

The organization

- object
  - `org_id` string, required
  - `allowance_usd_micros` integer

## Other responses

- `400`: Provide exactly one of wallet or email
- `403`: Not authorized for the requested wallet/email
- `404`: No organization for the wallet/email

---

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