# Convrgent AI Vault — List Human Profile IDs

> Convrgent AI Vault — List Human Profile IDs is a paid API for AI agents from convrgent.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns all human profile IDs and their metadata stored in the agent's namespaced vault, without returning full profile data.

## Facts

- Endpoint: POST https://convrgent.ai/api/vault/list
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convrgent-ai-b2ce43fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pezlhKMf3WEfhI4VqGXj1

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 convrgent-ai-b2ce43fd -d '<json body>'
```

Example prompt: Show me all the human profiles stored in my vault — just the IDs and metadata, not the full profile data.

## When to prefer this

Use this endpoint when an agent needs to discover which human profiles exist in its vault before deciding which full profile to fetch or update. Ideal as a prerequisite step before calling profile-fetch or update endpoints. Prefer this over full profile endpoints when you only need to check existence, count entries, or display a directory of tracked individuals.

## Known failure modes

- Empty vault returns an empty list rather than an error
- Invalid or missing wallet address returns authorization error
- Vault namespace not found returns 404 or empty response
- Payment failure (x402) results in 402 response before list is returned
- Rate limiting may return 429 if called in rapid succession

## How this service works

List all human profile IDs stored in the vault for this agent. Returns IDs and metadata without full profile data.

## Output

A list of all profile IDs stored in the agent's wallet-namespaced vault, along with lightweight metadata for each entry (such as creation timestamps, labels, or partial identifiers), but without the full psychological or personality profile payloads.

## Example request

```json
{
 "birth_date": "1990-06-15"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max profiles to return (default: 50)"
      },
      "offset": {
       "type": "integer",
       "description": "Pagination offset (default: 0)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 2,
  "profiles": [
   {
    "name": "Alice Chen",
    "created": "2026-03-20T10:00:00Z",
    "human_id": "alice-chen-001",
    "signal_count": 13
   },
   {
    "name": "Bob Smith",
    "created": "2026-03-19T08:00:00Z",
    "human_id": "bob-smith-002",
    "signal_count": 5
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convrgent-ai-b2ce43fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convrgent.ai](https://www.zero.xyz/host/convrgent.ai/llms.txt)