> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arcpass.vibepas.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /wallets/:address — Look Up a Wallet

> GET /wallets/:address — Retrieve a wallet profile by Ethereum address. Returns registration status, sponsorship count, and blocked flag.

Use this endpoint to fetch the current profile for a registered wallet address. You can call it to check whether a wallet is known to ArcPass, how many sponsorship requests it has submitted, and whether it has been blocked.

## Request

**`GET /wallets/:address`**

<ParamField path="address" type="string" required>
  The Ethereum address to look up. Must match `^0x[0-9a-fA-F]{40}$` and be at most 42 characters.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  UUID uniquely identifying this wallet record.
</ResponseField>

<ResponseField name="walletAddress" type="string" required>
  The registered Ethereum address, normalized to lowercase.
</ResponseField>

<ResponseField name="firstSeenAt" type="string" required>
  ISO 8601 timestamp of when this wallet was first registered with ArcPass.
</ResponseField>

<ResponseField name="lastSeenAt" type="string" required>
  ISO 8601 timestamp of the most recent interaction with this wallet.
</ResponseField>

<ResponseField name="sponsorshipCount" type="integer" required>
  Total number of sponsorship requests ever submitted for this wallet.
</ResponseField>

<ResponseField name="isBlocked" type="boolean" required>
  Whether this wallet has been flagged and blocked from receiving sponsorships.
</ResponseField>

## Errors

| Status | Cause                                                                  |
| ------ | ---------------------------------------------------------------------- |
| `400`  | The `:address` path parameter does not match the required hex pattern. |
| `404`  | No wallet with this address is registered in ArcPass.                  |

```bash theme={null}
curl --request GET \
  --url https://api.arcpass.io/wallets/0xAbC1234567890dEF1234567890aBcDeF12345678
```

```json 200 theme={null}
{
  "id": "3f2a1c8e-9b4d-4e7f-a1d2-0c6f8e3b5a9d",
  "walletAddress": "0xabc1234567890def1234567890abcdef12345678",
  "firstSeenAt": "2025-05-10T08:00:00.000Z",
  "lastSeenAt": "2025-05-11T10:22:00.000Z",
  "sponsorshipCount": 1,
  "isBlocked": false
}
```