# OnchainExpat Clubs Contacts API

> OnchainExpat Clubs Contacts API is a paid API for AI agents from x402.onchainexpat.com, paid per call via x402, $2/call, status unknown (last checked 2026-10-16).

Returns a list of expat club contacts for a given country, up to a configurable limit

## Facts

- Endpoint: POST https://x402.onchainexpat.com/api/x402/clubs/contacts?utm_source=zero.xyz
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onchainexpat-clubs-contacts-api-8240d535
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eSUeqgllVfJ2qWKG6jm4O

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 onchainexpat-clubs-contacts-api-8240d535 -d '<json body>'
```

Example prompt: Can you pull up the expat club contacts in Spain — grab up to 500 results?

## When to prefer this

Use this endpoint when you need structured contact data for expat clubs and organizations in a specific country, particularly for relocation research, expat community outreach, or building directories of international social groups. It is most suitable when country-scoped lookup is the primary filter and bulk retrieval (up to 5000 records) is needed.

## Known failure modes

- Invalid or unrecognized country slug returns empty results or an error
- Limit exceeding 5000 is rejected or capped
- Missing required fields may return an error or default behavior
- Payment failure via x402 protocol results in 402 response and no data returned
- Network timeout if the upstream contacts database is slow

## How this service works

Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol

## Output

A JSON list of expat club contact records filtered by country, containing up to the specified limit of results (default 1000, max 5000). Each record likely includes club name, contact details, and location information for expat organizations in the requested country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "country"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max results (default: 1000, max: 5000)"
  },
  "country": {
   "type": "string",
   "description": "Country slug, e.g., 'spain'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "clubs": {
   "type": "array",
   "description": "id, name, email, instagram, whatsapp_number, phone, website, public_url"
  },
  "count": {
   "type": "integer"
  },
  "total": {
   "type": "integer"
  },
  "country": {
   "type": "string"
  },
  "coverage": {
   "type": "object",
   "description": "How many clubs in the country carry each contact type"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onchainexpat-clubs-contacts-api-8240d535/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.onchainexpat.com](https://www.zero.xyz/host/x402.onchainexpat.com/llms.txt)