# Delx URL Allowlist Match

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

Checks whether a given URL matches any host/path pattern in a caller-supplied allowlist, returning a deterministic JSON result for use in agent preflight egress checks

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/url-allowlist-match
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-url-allowlist-match-f8e10324
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_81psIRqbM_VujwQuHpFlC

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-url-allowlist-match-f8e10324 -d '<json body>'
```

Example prompt: Before making an outbound call, check whether 'https://api.partner.com/v2/data' matches any of these allowlist patterns: ['api.partner.com/v2/*', 'api.trusted.org/*'].

## When to prefer this

Use this endpoint when an AI agent or automated pipeline needs a fast, stateless, deterministic check of whether a URL is permitted before making an outbound egress call — especially in preflight workflows where no persistent state, web search, or upstream RPC is desired. Prefer this over custom regex logic when you want a paid, auditable, micro-utility call with consistent JSON output. Best suited for single-URL spot checks rather than bulk URL filtering.

## Known failure modes

- Missing or malformed URL input returns a validation error
- Empty or null allowlist array returns no-match result
- Malformed pattern syntax in allowlist may produce unexpected match behavior
- Non-HTTP/HTTPS URL schemes may not match correctly depending on pattern format
- Network or service unavailability returns a 5xx error

## How this service works

Match a URL against host/path allowlist patterns before egress — first-party local utility for agent preflight and proven micro-utils expansion. Returns deterministic machine-readable JSON for $0.001 USDC via x402 on Base. Execution is first-party, local-only, stateless, and memory-only with no paid upstream, no input retention, no web search, no live RPC, and no mediagen. Results are advisory; the caller owns authorization, budgets, and production controls. Sibling of Delx routes that already…

## Output

Returns a deterministic JSON object indicating whether the input URL matched any pattern in the provided allowlist, along with which pattern matched (if any). The response is machine-readable, stateless, and advisory — the caller retains responsibility for final authorization decisions.

## 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-url-allowlist-match-f8e10324/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)