VUMI Documentation
  • Introduction
    • 🎉Welcome!
    • ➡️Quick Start
  • Platform
    • App Overview
      • API Products
      • Connections Overview
      • API Configuration
    • Link Overview
      • Link redirects
      • Link parameters
      • Customization
  • General API Resources
    • Authentication
      • API Login
    • Entities
      • List entities for app
    • Connections
      • Exchange public token
      • Get Connection status
      • List all connections
      • List public tokens
      • Delete Connection
    • Investments
      • List investments
    • Webhook
      • Get verification key
  • Aggregation
    • Accounts
      • List accounts
      • List account transactions
    • Portfolios
      • List portfolios
      • List portfolio transactions
      • List portfolio positions
  • Assets Transfer
    • Assets transfer
  • Developer Resources
    • API and Widget Errors
    • Webhooks and security
      • Webhook verification
    • Pagination
    • Tracing requests
Powered by GitBook
On this page
  • Response Codes
  • How to respond to different errors
  • Status code 5xx
  • Status code 4xx
  1. Developer Resources

API and Widget Errors

On this page you will find the different errors our API and Widget can return, alongside with the http statuses. These include controlled and uncontrolled errors.

Last updated 11 months ago


At Vumi, we work hard to ensure a smooth experience with our app by rigorously testing to minimize errors. However, we know that sometimes issues are unavoidable. We have created this guide to help you handle them adequately when they occur.

Response Codes

Status Code
Description

200

✅ Success - The requested action was performed succesfully

400

❌ Bad request - The request returned an error, typically due to missing or incorrect information.

401

❌ Unauthorized - Credentials are missing or invalid. This typically means you need to refresh the session.

403

❌ Forbidden - You are not allowed to perform the requested action.

404

❌ Not Found - The resource you are trying to access could not be found based on the information you provided.

500

❌ Internal Server Error - An uncontrolled error has occurred.

How to respond to different errors

Status code 5xx

5xx status code indicate server-side errors. These types of errors are typically temporary and may resolve themselves without intervention. For that reason, we recommend you implement a retry logic with incremental delays for 3-5 times before reporting the error to us. A common approach, and the one we do reccommend, is the , which adds randomness to the delay to prevent synchronized retries from multiple clients.

Status code 4xx

4xx status codes are controlled errors from our systems. These typically mean your request was either lacking important information or the information you provided is incorrect. For that reason, when you encounter these type of status codes you should not retry the same request.

exponential backoff with jitter