Configurable Axios Interceptor to retry failed http calls.
Branch: master
Clone or download
Latest commit a89e391 May 27, 2018

Axios Retry Interceptor

Build Status dependencies Status npm version License: MIT

Configurable Axios Interceptor to retry failed http calls.


npm install --save axios-retry-interceptor



import retryInterceptor from 'axios-retry-interceptor';
// or
const retryInterceptor = require('axios-retry-interceptor');

Set the interceptor for your axios instance. Voila!

retryInterceptor(axios, {
  maxAttempts: 3,
  waitTime: 1000


retryInterceptor(axiosInstance, options)

  • axiosInstance - your axios instance
  • options - config for retry interceptor



Max number of times the interceptor should retry the failed http call.

Type: Number

Default: 3

Example: maxAttempts: 5


Duration between each retry attempt in milliseconds(1s=1000ms).

Type: Number

Default: 0

Example: waitTime: 3000


Response errorCodes for which the interceptor should retry.

Ideally any implementation should retry only 5xx status(server errors) and should not retry 4xx status(client errors). The reason is, if a http call fails with a client error, then the retry call will have the same headers/params and will obviously fail. So by default all 5xx errors will be retried. If you want to customize the status for which the retries should be made, use this config.

Type: Array

Default: []

Example: errorCodes: [500, 501, 401]

Author's note

Ideally only idempotent http methods (GET, PUT, DELETE, HEAD, OPTIONS) should be retried on failed http calls. Non-idempotent methods like POST should NOT be retried and that's why this library will not permit retry of non-idempotent methods.


MIT © Dinesh Pandiyan