---
title: "Look up organization billing state"
method: GET
path: "/orgs/v1/lookup"
tags: ["Billing"]
---

# Look up organization billing state

`GET /orgs/v1/lookup`

## Request

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

Returns balance, tier, lease expiry, and auto-recharge config for the organization associated with a wallet or email. Provide exactly one of wallet or email. Wallet lookups require either an admin key or a SIWX header signed by the queried wallet. Email lookups require admin key.

## Query parameters

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

## Response `200`

Organization billing state

- object
  - `allowance_usd_micros` integer, required: Available balance in micro-USD (1 USD = 1,000,000)

## Other responses

- `401`: Missing or invalid SIWX header (and no admin key)
- `403`: SIWX wallet does not match the wallet query parameter, or email lookup lacks admin key

---

[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)