---
name: read-endpoint-health
description: Is an x402 API up and payable right now? One unpaid GET reports whether it answered, how long it took, and whether its payment request is complete. Does not pay the URL. Not a security review. 0.01 USDC. Not free while payments are down: that call returns 503.
---

# Endpoint health

## When to use

Use before an agent pays an x402 API, to see whether the URL answers and whether its 402 lists scheme, network, asset, amount and payTo. This is not /api/x402-health, which only checks KeeSpecs' own payment service.

## Request

GET https://keespecs.xyz/api/endpoint-health?url={url}. 0.01 USDC. url is required and must be an https address. Only https on port 443 is checked. Addresses with a user name or password, local or private hosts, and URLs longer than 2048 characters return 400 and are not charged. While payments are down, this call returns 503. A missing payment returns 402.

## Fields

- reached is true when any HTTP response arrived, including 402, 4xx and 5xx.
- payable is true only when the URL answered 402 with a complete payment request. A 200 is not payable, even with a payment request.
- payment_request is complete, incomplete, or absent. accepts shows scheme, network, asset, amount and payTo from the first complete entry. missing lists the fields that were absent.
- network is shown as the URL gave it, for example keeta:21378. Other networks are reported, not refused.
- redirects lists up to 2 https redirects that were followed, and any redirect that was refused and why.
- error is dns, tls, unreachable, too_large, or null. A URL that does not answer is still a charged check.
- note is: One unpaid GET as of asOf. Whether this URL answered and whether its payment request was complete. Does not pay the URL. Not a security review.

Catalogue: https://keespecs.xyz/apis
Skills: https://keespecs.xyz/skills
Sending, bridging, banks, cards, and identity: https://keeta.ai/llms.txt
