# Delx Commerce — URL Allowlist Match

> Delx Commerce — URL Allowlist Match is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Checks whether a given URL matches any pattern in a provided allowlist, returning host, path, and match details.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/url-allowlist-match?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-url-allowlist-match-29b16e65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZnFrtV-LHDflA5Suukfqv

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 delx-commerce-url-allowlist-match-29b16e65 -d '<json body>'
```

Example prompt: Before you call that external endpoint, check whether https://api.delx.ai/api/v1/x402/hash is allowed against my allowlist of ['api.delx.ai', 'api.openai.com'].

## When to prefer this

Use this endpoint when an AI agent needs a fast, verifiable, pay-per-use check of whether a URL is permitted by a policy allowlist before making outbound calls. Prefer it over client-side regex matching when you need an auditable, neutral third-party validation with a cryptographic payment trail via x402/USDC, especially in multi-agent or zero-trust environments.

## Known failure modes

- URL is malformed or unparseable — returns ok:false or validation error
- Allowlist is empty or not provided — no patterns to match against, returns allowed:false
- URL does not match any allowlist entry — returns allowed:false with no matched_pattern
- Network or service error — HTTP 5xx or payment-related 402 if payment not attached

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

Returns a JSON object with 'ok' (boolean), 'allowed' (boolean), 'host' (string), 'path' (string), 'scheme' (string), 'matched_pattern' (string if matched), and 'schema' identifier. Tells the caller definitively whether the URL is allowed and which pattern it matched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Input field: url."
  },
  "allowlist": {
   "type": "array",
   "description": "Input field: allowlist."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "host": "api.delx.ai",
  "path": "/api/v1/x402/hash",
  "schema": "delx/util-url-allowlist-match/v1",
  "scheme": "https",
  "allowed": true,
  "matched_pattern": "api.delx.ai"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-url-allowlist-match-29b16e65/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)