---
title: "Lookup Proxy Key"
method: POST
path: "/auth/proxy/lookup"
---

# Lookup Proxy Key

`POST /auth/proxy/lookup`

Retrieve metadata for a single proxy key you own. Replaces the legacy `GET /auth/proxy/{proxy_key}`; uses a static URL so the path can be exact-matched at the edge.

## Request body

- ProxyKeyLookupRequest
  - `proxy_key` string, required — The proxy key to look up / toggle / delete (must be one you own)

## Response `200`

Success

- ProxyKey
  - `name` string, required — Name of the proxy key
  - `expires_at` integer, required — Expiration timestamp (-1 for no expiration)
  - `allocated_ammount` number, required — Allocated credit amount
  - `model_whitelist` string[] — List of allowed models
  - `ip_whitelist` string[] — List of allowed IP addresses or CIDR blocks
  - `used_ammount` number — Amount of credits used
  - `is_active` boolean — Whether the proxy key is active
  - `key` string — The proxy key value
  - `created_at` integer — Creation timestamp
  - `last_used` integer — Last usage timestamp

## Other responses

- `401` — Missing, invalid, or non-API-key Authorization header
- `403` — Proxy key is owned by a different account
- `404` — Proxy key not found

---

[API](https://skmtc.dev/electronhub/apis/electron-hub-api.md) · [All operations](https://skmtc.dev/electronhub/apis/electron-hub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/electronhub/electron-hub-api/revisions/727f9c51555b/schema)