LidyaDocs

Applications API

This endpoint backs the public form at lidya.money/apply. It accepts un-authenticated POSTs — there is no API key yet at the point a merchant submits.

Submit an application

POST /v1/applications

Request

{
  "companyName": "Acme Forex Ltd",
  "jurisdiction": "Cyprus",
  "vertical": "forex",
  "monthlyVolumeUSD": 250000,
  "currentAcquirer": "Stripe (declined)",
  "whySwitching": "Stripe rate-limited us last month and rejected our risk profile.",
  "contactName": "Jane Doe",
  "contactEmail": "jane@acmeforex.example",
  "telegram": "@janedoe"
}
FieldTypeRequiredNotes
companyNamestringyes
jurisdictionstringyesCountry of registration.
verticalenumyesSee list below.
verticalOtherstringconditionalRequired when vertical = "other".
monthlyVolumeUSDintegeryesEstimated. Minimum 1,000.
currentAcquirerstringno
whySwitchingstringnoFree text. ≤2000 chars.
contactNamestringyes
contactEmailstringyesValid email.
telegramstringnoOptional Telegram handle for fast replies.

Verticals

forex, betting, iptv, adult, dating, nutra, dropshipping, cryptoSaaS, affiliate, other

Response — 201 Created

{
  "id": "app_01HYPR…",
  "status": "NEW",
  "createdAt": "2026-05-06T12:00:00.000Z"
}

Underwriting reviews most applications within 48 hours. Approved merchants receive their first API keys via the email provided.