# Inbox Lease Status and Pending Message Count

> Inbox Lease Status and Pending Message Count is a paid API for AI agents from inbox.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-15, last successful call 2026-07-29).

Returns the current lease status, expiry date, and number of pending unacknowledged messages for the caller's inbox.

## Facts

- Endpoint: GET https://inbox.withzero.xyz/api/v1/inboxes/me
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-07-29
- Success rate: 67% of calls made through Zero
- Activations on Zero: 4
- Provider: inbox.withzero.xyz
- Website: https://inbox.withzero.xyz
- Canonical page: https://www.zero.xyz/c/inbox-withzero-xyz-inbox-lease-status-and-pending-message-count-699914ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CRbd4lkUnLdR7Z13vv1ir

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability inbox-withzero-xyz-inbox-lease-status-and-pending-message-count-699914ba
```

Example prompt: Check my withzero inbox status — I want to know if my lease is still active, when it expires, and how many messages are waiting to be drained.

## When to prefer this

Use this endpoint when an agent needs to check its inbox health before draining events, verify whether its lease needs renewal, or determine how many pending messages are queued. Prefer this over the drain endpoint when you only need status metadata without consuming messages.

## Known failure modes

- Invalid or missing signed proof credential — 401 unauthorized
- Inbox not yet provisioned for this wallet — 404 not found
- Expired lease may return active: false rather than an error
- Network timeout or service unavailability — 5xx error

## How this service works

Lease status and pending-message count. 📖 Full guide: https://inbox.withzero.xyz/llms.txt

## Output

Returns a JSON object with: owner (wallet address), active (boolean indicating if lease is valid), expiresAt (ISO timestamp of lease expiry), pendingMessages (count of unacknowledged unexpired messages), maxMessages (quota cap), messageTtlDays (message time-to-live), and lifetimeTopups (number of times the lease has been topped up).

## Example request

```json
{}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "owner",
  "expiresAt",
  "active",
  "messageTtlDays",
  "maxMessages",
  "lifetimeTopups",
  "pendingMessages"
 ],
 "properties": {
  "owner": {
   "type": "string"
  },
  "active": {
   "type": "boolean",
   "description": "False once the lease has expired — top up to restore."
  },
  "expiresAt": {
   "type": "string"
  },
  "maxMessages": {
   "type": "number"
  },
  "lifetimeTopups": {
   "type": "number"
  },
  "messageTtlDays": {
   "type": "number"
  },
  "pendingMessages": {
   "type": "number",
   "description": "Unacked, unexpired messages waiting to be drained."
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/inbox-withzero-xyz-inbox-lease-status-and-pending-message-count-699914ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from inbox.withzero.xyz](https://www.zero.xyz/host/inbox.withzero.xyz/llms.txt)