Do not miss any Lumepay API changes, ever again

Subscribe to the Lumepay API changelog to be up to date on recent changes.

RSS
Lumepay API

Aug 3, 2026

main
v1
Compare

API structure has changed

Next change
32 structure changes including:
6 Breaking changes
13 Additions
15 Modifications
4 Removals
Modified 15 Breaking
GET /api/v1/currencies
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
  • Response
  • 429, 403, 500, 400, 401 responses Added
GET /api/v1/beneficiaries/{beneficiaryId}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • id, currency, nickname, withdrawFormDetails, createdAt properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 400, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
GET /api/v1/beneficiaries
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
  • Response
  • 429, 403, 500, 400, 401 responses Added
GET /api/v1/accounts/{accountId}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • id, currency, balance, lockedBalance properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 400, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
GET /api/v1/accounts/currency/{currency}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • id, currency, balance, lockedBalance properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 400, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
GET /api/v1/accounts
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
  • Response
  • 429, 403, 500, 400, 401 responses Added
GET /api/v1/deposits
  • Response
  • 200 response Modified
    • application/json content type Modified
      • accountId property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
  • 429, 403, 500, 400, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
GET /api/v1/deposits/{transactionId}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • accountId property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
  • 404 response Modified
    • application/json content type Modified
      • currency, accountId, transactionId, amount, fee, status, completedAt properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 400, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
GET /api/v1/wallets
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
  • Response
  • 429, 403, 500, 400, 401 responses Added
GET /api/v1/wallets/{walletId}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • id, currency, depositDetails, networkName, paymentMethodType properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 400, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
GET /api/v1/withdrawals
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
  • Response
  • 429, 403, 500, 400, 401 responses Added
GET /api/v1/withdrawals/{transactionId}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • amount, fee, currency, withdrawDetails, status, transactionId, createdAt, completedAt, isFiat properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 400, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
POST /api/v1/accounts
  • Response
  • 400 response Modified
    • application/json content type Modified
      • id, currency, balance, lockedBalance properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 404 response Modified
    • application/json content type Modified
      • id, currency, balance, lockedBalance properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 409 response Modified
    • application/json content type Modified
      • id, currency, balance, lockedBalance properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
POST /api/v1/conversions/quote
  • Path went from /api/v1/trades/quote to /api/v1/conversions/quote (same operationId)
    Breaking
  • Body
  • application/json content type Modified
    • amount, amountMode properties Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • fromAmount, toAmount properties Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • amount, fromCurrency, toCurrency, toAmount, rate, quoteStr, fromAmount, quoteAmountMode properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
  • 400 response Modified
    • application/json content type Modified
      • amount, fromCurrency, toCurrency, toAmount, rate, quoteStr, fromAmount, quoteAmountMode properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
POST /api/v1/conversions/quote/confirm
  • Path went from /api/v1/trades/quote/confirm to /api/v1/conversions/quote/confirm (same operationId)
    Breaking
  • Body
  • application/json content type Modified
    • amount property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • fromAmount, toAmount properties Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Type is no longer object
        Breaking
      • ExternalAcceptRFQQuoteResponse property Removed
  • 400 response Modified
    • application/json content type Modified
      • tradeNo, fillNo, completed properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • code, message, httpStatus, requestId, timestamp, errors properties Added
  • 429, 403, 500, 401 responses Added
  • Authentication
  • X api key & X api secret authentication method Removed
    • Removing a resource is always breaking unless it was deprecated before
      Breaking
  • Header
  • X-API-KEY, X-API-SECRET headers Added
Removed 4 Breaking
X api key & X api secretauthentication method
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
GET /api/v1/trades
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
GET /api/v1/trades/{transactionId}
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
POST /api/v1/beneficiaries/withdrawals
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
Added 13
POST /api/v1/withdrawals/beneficiaries/{beneficiaryId}
POST /api/v1/webhooks/test-event
POST /api/v1/webhooks/subscriptions/{subscriptionId}/verify
POST /api/v1/webhooks/subscriptions/{subscriptionId}/events
POST /api/v1/webhooks/subscriptions/{subscriptionId}/deactivate
POST /api/v1/webhooks/subscriptions/{subscriptionId}/activate
POST /api/v1/webhooks/subscriptions
POST /api/v1/beneficiaries/withdrawals
GET /api/v1/webhooks/subscriptions/{subscriptionId}
GET /api/v1/webhooks/subscriptions
GET /api/v1/webhooks/events
GET /api/v1/payment-reasons
DELETE /api/v1/webhooks/subscriptions/{subscriptionId}/events