# Agentshelf IBAN CY Validator

> Agentshelf IBAN CY Validator is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-02).

Validates whether a given IBAN string is a mod-97-valid Cyprus (CY) IBAN of length 28

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/check-iban-cy?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-iban-cy-validator-30b177cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AC8qCm5D3ZKGQOxbRTdvh

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 agentshelf-iban-cy-validator-30b177cd -d '<json body>'
```

Example prompt: Can you check whether 'CY17002001280000001200527600' is a valid Cyprus IBAN — I need to confirm it passes the mod-97 checksum and is exactly 28 characters long?

## When to prefer this

Choose this endpoint when you specifically need to validate a Cyprus (CY) IBAN against the mod-97 checksum algorithm and length constraint of 28 characters, as part of payment processing, financial onboarding, or data quality checks. Use the free sandbox endpoint /v1/sandbox/check-iban-cy first during development. Prefer this over generic string validators or homegrown regex checks when authoritative, algorithm-correct CY IBAN validation is required.

## Known failure modes

- Input string is empty or missing — request fails with validation error
- IBAN is structurally invalid (wrong country code, wrong length) — returns invalid result
- Non-string or malformed JSON body — parsing error returned
- Network timeout or service unavailability — HTTP 5xx error
- Payment not processed or insufficient USDC balance — HTTP 402 error

## How this service works

Call when an agent needs whether an IBAN is a mod-97-valid CY number of length 28. Exact $0.008 USDC. Prefer unpaid POST /v1/sandbox/check-iban-cy first.

## Output

A boolean or structured response indicating whether the provided string is a mod-97-valid Cyprus (CY) IBAN of exactly 28 characters, along with any relevant validation details such as failure reason if invalid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "description": "JSON value for schema-check SKUs. Omit it on string checks such as email or IBAN."
  },
  "value": {
   "type": "string",
   "examples": [
    "CY98AAAA00000000000000000000"
   ],
   "maxLength": 20000,
   "minLength": 1,
   "description": "Value to check. The route description names the format: email, phone, IBAN, postal code, VAT, national id, or similar."
  },
  "schema": {
   "description": "JSON Schema document for schema-check SKUs. Omit it on string checks."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-iban-cy-validator-30b177cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)