\n \n | \n \n \n \n \n Free tools to help with your financial planning needs!\n \n \n principal.com\n \n | \n \n \n \n \n \n BSAP SE, a global software company, is one of the largest vendors of ERP and other enterprise applications.\n \n \n opensource.sap.com\n \n | \n \n \n \n \n \n Reduce user friction, prevent account takeover, and get a 360° view of your customer and agentic identities with the Descope External IAM platform.\n \n \n descope.com\n \n | \n
\n \n | \n \n \n \n \n The identity platform for humans & AI agents\n \n \n stytch.com\n \n | \n \n \n \n \n \n RxDB is a NoSQL database for JavaScript that runs directly in your app.\n \n \n rxdb.info\n \n | \n \n \n \n \n \n Buy Instagram Likes\n \n \n poprey.com\n \n | \n
\n \n | \n \n \n \n \n At Buzzoid, you can buy Instagram followers through a short checkout flow with safety controls. Rated world's #1 IG service since 2012.\n \n \n buzzoid.com\n \n | \n \n \n \n \n \n Buy real Instagram followers from Twicsy. Twicsy has been voted the best site to buy followers from the likes of US Magazine.\n \n \n twicsy.com\n \n | \n \n \n \n \n \n Fun88 is a global online gambling and betting brand founded in 2009, offering a wide range of services including sports betting, live casino games, slots, and virtual gaming.\n \n \n global.fun88.com\n \n | \n
\n
\n\n\n\n\n\n\n[](https://www.npmjs.org/package/axios)\n[](https://github.com/axios/axios/actions/workflows/ci.yml)\n[](https://gitpod.io/#https://github.com/axios/axios)\n[](https://packagephobia.now.sh/result?p=axios)\n[](https://bundlephobia.com/package/axios@latest)\n[](https://npm-stat.com/charts.html?package=axios)\n[](https://gitter.im/mzabriskie/axios)\n[](https://www.codetriage.com/axios/axios)\n[](CONTRIBUTORS.md)\n[](https://agentfriendlycode.com/repo/32)\n\n
\n\n## Table of contents\n\n- [Features](#features)\n- [Browser support](#browser-support)\n- [Installing](#installing)\n - [Package manager](#package-manager)\n - [CDN](#cdn)\n- [Example](#example)\n- [Axios API](#axios-api)\n- [Request method aliases](#request-method-aliases)\n- [Concurrency](#concurrency-deprecated)\n- [Creating an instance](#creating-an-instance)\n- [Instance methods](#instance-methods)\n- [Request config](#request-config)\n- [Response schema](#response-schema)\n- [Config defaults](#config-defaults)\n - [Global axios defaults](#global-axios-defaults)\n - [Custom instance defaults](#custom-instance-defaults)\n - [Config order of precedence](#config-order-of-precedence)\n- [Interceptors](#interceptors)\n - [Multiple interceptors](#multiple-interceptors)\n- [Handling errors](#handling-errors)\n- [Handling timeouts](#handling-timeouts)\n- [Cancellation](#cancellation)\n - [AbortController](#abortcontroller)\n - [CancelToken](#canceltoken-deprecated)\n- [Using application/x-www-form-urlencoded format](#using-applicationx-www-form-urlencoded-format)\n - [URLSearchParams](#urlsearchparams)\n - [Query string](#query-string-older-browsers)\n - [Automatic serialization](#automatic-serialization-to-urlsearchparams)\n- [Using multipart/form-data format](#using-multipartform-data-format)\n - [FormData](#formdata)\n - [Automatic serialization](#automatic-serialization-to-formdata)\n- [Posting files](#posting-files)\n- [HTML form posting](#html-form-posting-browser)\n- [Progress capturing](#progress-capturing)\n- [Rate limiting](#rate-limiting)\n- [AxiosHeaders](#axiosheaders)\n- [Fetch adapter](#fetch-adapter)\n - [Custom fetch](#custom-fetch)\n - [Using with Tauri](#using-with-tauri)\n - [Using with SvelteKit](#using-with-sveltekit)\n- [HTTP/2 support](#http2-support)\n- [Semver](#semver)\n- [Promises](#promises)\n- [TypeScript](#typescript)\n- [Contributing](#contributing)\n - [Local setup](#local-setup)\n- [Resources](#resources)\n- [Credits](#credits)\n- [License](#license)\n\n## Features\n\n- Make [XMLHttpRequests](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest) from the browser.\n- Make [http](https://nodejs.org/api/http.html) requests from Node.js.\n- Use the [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) API for asynchronous request handling.\n- Intercept requests and responses to add custom logic or transform data.\n- Transform request and response data.\n- Cancel requests with built-in cancellation APIs.\n- Serialize and parse [JSON](https://www.json.org/json-en.html) data.\n- Serialize data objects to `multipart/form-data` or `application/x-www-form-urlencoded`.\n- Add client-side protection against [Cross-Site Request Forgery](https://en.wikipedia.org/wiki/Cross-site_request_forgery).\n\n## Browser support\n\n| Chrome | Firefox | Safari | Opera | Edge |\n| :------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------: |\n|  |  |  |  |  |\n| Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ |\n\n[](https://saucelabs.com/u/axios)\n\n## Installing\n\n### Package manager\n\nUsing npm:\n\n```bash\n$ npm install axios\n```\n\nUsing yarn:\n\n```bash\n$ yarn add axios\n```\n\nUsing pnpm:\n\n```bash\n$ pnpm add axios\n```\n\nUsing bun:\n\n```bash\n$ bun add axios\n```\n\nOnce the package is installed, import it with `import` or `require`:\n\n```js\nimport axios, { isCancel, AxiosError } from 'axios';\n```\n\nYou can also use the default export, since the named export is just a re-export from the Axios factory:\n\n```js\nimport axios from 'axios';\n\nconsole.log(axios.isCancel('something'));\n```\n\nIf you use `require` for importing, **only the default export is available**:\n\n```js\nconst axios = require('axios');\n\nconsole.log(axios.isCancel('something'));\n```\n\nSome bundlers and ES6 linters need this form:\n\n```js\nimport { default as axios } from 'axios';\n```\n\nIn custom or legacy environments, you can import the bundle directly:\n\n```js\nconst axios = require('axios/dist/browser/axios.cjs'); // browser commonJS bundle (ES2017)\n// const axios = require('axios/dist/node/axios.cjs'); // node commonJS bundle (ES2017)\n```\n\n### CDN\n\nUsing jsDelivr CDN (ES5 UMD browser module):\n\n```html\n\n```\n\nUsing unpkg CDN:\n\n```html\n\n```\n\n## Example\n\n```js\nimport axios from 'axios';\n//const axios = require('axios'); // legacy way\n\ntry {\n const response = await axios.get('/user?ID=12345');\n console.log(response);\n} catch (error) {\n console.error(error);\n}\n\n// Optionally the request above could also be done as\naxios\n .get('/user', {\n params: {\n ID: 12345,\n },\n timeout: 5000, // 5 seconds. See \"Handling Timeouts\" below for matching error handling\n })\n .then(function (response) {\n console.log(response);\n })\n .catch(function (error) {\n console.log(error);\n })\n .finally(function () {\n // always executed\n });\n\n// Want to use async/await? Add the `async` keyword to your outer function/method.\nasync function getUser() {\n try {\n// Example: GET request with query parameters\nconst response = await axios.get('/user', {\n params: {\n ID: 12345\n }\n});\n\n// Using the `params` option improves readability and automatically formats query strings\n\nconsole.log(response);\n } catch (error) {\n console.error(error);\n }\n}\n```\n\n> Note: Set a `timeout` in production. Without one, a stalled request can hang\n> indefinitely. See [Handling Timeouts](#handling-timeouts) for the matching error handling.\n\n> Note: `async/await` is part of ECMAScript 2017 and is not supported in Internet\n> Explorer and older browsers, so use with caution.\n\nPerforming a `POST` request\n\n```js\nconst response = await axios.post('/user', {\n firstName: 'Fred',\n lastName: 'Flintstone',\n});\nconsole.log(response);\n```\n\nPerforming multiple concurrent requests\n\n```js\nfunction getUserAccount() {\n return axios.get('/user/12345');\n}\n\nfunction getUserPermissions() {\n return axios.get('/user/12345/permissions');\n}\n\nPromise.all([getUserAccount(), getUserPermissions()]).then(function (results) {\n const acct = results[0];\n const perm = results[1];\n});\n```\n\n## axios API\n\nRequests can be made by passing the relevant config to `axios`.\n\n##### axios(config)\n\n```js\n// Send a POST request\naxios({\n method: 'post',\n url: '/user/12345',\n data: {\n firstName: 'Fred',\n lastName: 'Flintstone',\n },\n});\n```\n\n```js\n// GET request for remote image in node.js\nconst response = await axios({\n method: 'get',\n url: 'https://bit.ly/2mTM3nY',\n responseType: 'stream',\n});\nresponse.data.pipe(fs.createWriteStream('ada_lovelace.jpg'));\n```\n\n##### axios(url[, config])\n\n```js\n// Send a GET request (default method)\naxios('/user/12345');\n```\n\n### Request method aliases\n\nFor convenience, aliases have been provided for all common request methods.\n\n##### axios.request(config)\n\n##### axios.get(url[, config])\n\n##### axios.delete(url[, config])\n\n##### axios.head(url[, config])\n\n##### axios.options(url[, config])\n\n##### axios.post(url[, data[, config]])\n\n##### axios.put(url[, data[, config]])\n\n##### axios.patch(url[, data[, config]])\n\n###### Note\n\nWhen using the alias methods `url`, `method`, and `data` properties don't need to be specified in config.\n\n### Concurrency (deprecated)\n\nUse `Promise.all` instead of these helpers.\n\nHelper functions for dealing with concurrent requests.\n\naxios.all(iterable)\naxios.spread(callback)\n\n### Creating an instance\n\nYou can create a new instance of axios with a custom config.\n\n##### axios.create([config])\n\n```js\nconst instance = axios.create({\n baseURL: 'https://some-domain.com/api/',\n timeout: 1000,\n headers: { 'X-Custom-Header': 'foobar' },\n});\n```\n\n### Instance methods\n\nThe following instance methods are available. Axios merges the specified config with the instance config.\n\n##### axios#request(config)\n\n##### axios#get(url[, config])\n\n##### axios#delete(url[, config])\n\n##### axios#head(url[, config])\n\n##### axios#options(url[, config])\n\n##### axios#post(url[, data[, config]])\n\n##### axios#put(url[, data[, config]])\n\n##### axios#patch(url[, data[, config]])\n\n##### axios#getUri([config])\n\n## Request config\n\n### Security notice: decompression-bomb protection is opt-in\n\nBy default `maxContentLength` and `maxBodyLength` are `-1` (unlimited). A malicious or compromised server can return a tiny gzip/deflate/brotli/zstd body that expands to gigabytes and exhaust the Node.js process.\n\nIf you call servers you do not fully trust, **set a cap**:\n\n```js\naxios.defaults.maxContentLength = 10 * 1024 * 1024; // 10 MB\naxios.defaults.maxBodyLength = 10 * 1024 * 1024;\n```\n\nSee the [security guide](https://axios.rest/pages/misc/security.html) for details.\n\nThese config options are available for requests. Only `url` is required. Requests default to `GET` when `method` is not set.\n\n```js\n{\n // `url` is the server URL for the request\n url: '/user',\n\n // `method` is the request method to be used when making the request\n method: 'get', // default\n\n // Axios prepends `baseURL` to `url` unless `url` is absolute and `allowAbsoluteUrls` is set to true.\n // It can be convenient to set `baseURL` for an instance of axios to pass relative URLs\n // to the methods of that instance.\n baseURL: 'https://some-domain.com/api/',\n\n // `allowAbsoluteUrls` determines whether or not absolute URLs will override a configured `baseUrl`.\n // When set to true (default), absolute values for `url` will override `baseUrl`.\n // When set to false, absolute values for `url` will always be prepended by `baseUrl`.\n allowAbsoluteUrls: true,\n\n // `transformRequest` allows changes to the request data before it is sent to the server\n // This is only applicable for request methods 'PUT', 'POST', 'PATCH' and 'DELETE'\n // The last function in the array must return a string or an instance of Buffer, ArrayBuffer,\n // FormData or Stream\n // You may modify the headers object.\n transformRequest: [function (data, headers) {\n // Do whatever you want to transform the data\n\n return data;\n }],\n\n // `transformResponse` allows changes to the response data to be made before\n // it is passed to then/catch\n transformResponse: [function (data) {\n // Do whatever you want to transform the data\n\n return data;\n }],\n\n // `parseReviver` is an optional function passed as the\n // second argument (reviver) to JSON.parse()\n parseReviver: function (key, value, context) {\n // In modern environments, context.source provides the raw JSON string\n // allowing for precision-safe parsing of BigInt\n if (typeof value === 'number' && context?.source) {\n const isInteger = Number.isInteger(value);\n const isUnsafe = !Number.isSafeInteger(value);\n const isValidIntegerString = /^-?\\d+$/.test(context.source);\n\n if (isInteger && isUnsafe && isValidIntegerString) {\n try {\n return BigInt(context.source);\n } catch {\n // Fallback: return original value if parsing fails\n }\n }\n }\n return value;\n },\n\n // `headers` are custom headers to be sent\n headers: {'X-Requested-With': 'XMLHttpRequest'},\n\n // `params` are the URL parameters to be sent with the request\n // Must be a plain object or a URLSearchParams object\n params: {\n ID: 12345\n },\n\n // `paramsSerializer` is an optional config that allows you to customize serializing `params`.\n paramsSerializer: {\n\n // Custom encoder function which sends key/value pairs in an iterative fashion.\n encode?: (param: string): string => { /* Do custom operations here and return transformed string */ },\n\n // Custom serializer function for the entire parameter. Allows the user to mimic pre 1.x behaviour.\n serialize?: (params: Record![\"Axios\"](\"https://axios.rest/logo.svg\"){kind=logo}