L402 Apps API Endpoint

Submit a verified L402 API

This route is intended for server-to-server calls. POST https://www.l402apps.com/api/api-submissions

Request body

  • url (required): the endpoint URL to verify.
  • invoice: a 100-sat BOLT11 invoice for payout (preferred).
  • lightningAddress: a Lightning address, e.g. user@wallet.com (fallback if you can't generate an invoice).
  • description (optional): your endpoint description.

Provide either invoice or lightningAddress to receive your 100 sat reward.

{
  "url": "https://api.example.com/v1/endpoint",
  "invoice": "lnbc100n1...",
  "description": "Optional human-readable description"
}

// Or with a Lightning address:
{
  "url": "https://api.example.com/v1/endpoint",
  "lightningAddress": "you@wallet.com"
}

Example cURL

# With BOLT11 invoice (default):
curl -X POST "https://www.l402apps.com/api/api-submissions" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.example.com/v1/endpoint",
    "invoice": "lnbc100n1..."
  }'

# With Lightning address (fallback):
curl -X POST "https://www.l402apps.com/api/api-submissions" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.example.com/v1/endpoint",
    "lightningAddress": "you@wallet.com"
  }'

Submitters receive 100 sats after successful verification.

Use the web submit flow View API directory endpoint