feat: add a generic API request interface (#540)

# Description

Adds a generic API request interface to make arbitrary API requests.

# Testing

- All tests pass
- New unit test added for the `makeApiCall` method

# Pull Request Type

Please select the option(s) that are relevant to this PR.

- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] Improvement (fixing a typo, updating readme, renaming a variable
name, etc)

---------

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: Justintime50

CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## v8.7.0 (2026-02-25)
+
+- Adds generic `makeApiCall` function
+
 ## v8.6.0 (2026-02-20)
 
 - Adds the following functions:

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "@easypost/api",
   "description": "EasyPost Node Client Library",
-  "version": "8.6.0",
+  "version": "8.7.0",
   "author": "Easypost Engineering <oss@easypost.com>",
   "homepage": "https://easypost.com",
   "exports": {

package.json

@@ -115,6 +115,23 @@ export default class EasyPostClient {
     this.responseHooks = [];
   }
 
+  /**
+   * Make an API call to the EasyPost API.
+   *
+   * This public, generic interface is useful for making arbitrary API calls to the EasyPost API that
+   * are not yet supported by the client library's services. When possible, the service for your use case
+   * should be used instead as it provides a more convenient and higher-level interface depending on the endpoint.
+   * @param {string} method - The HTTP method to use (e.g. 'get', 'post', 'put', 'patch', 'del').
+   * @param {string} endpoint - The API endpoint to call (e.g. '/addresses').
+   * @param {Object} [params] - The parameters to send with the request.
+   * @returns {Promise<Object>} The response from the API call.
+   */
+  async makeApiCall(method, endpoint, params = {}) {
+    const response = await this._request(endpoint, method, params);
+
+    return response.body;
+  }
+
   /**
    * Create a copy of an {@link EasyPostClient} with overridden options.
    * @param {EasyPostClient} client The `EasyPostClient` instance to clone.

src/easypost.js

@@ -147,4 +147,13 @@ describe('EasyPost', function () {
     expect(responseConfig1).to.be.null;
     expect(responseConfig2).to.be.null;
   });
+
+  it('makes an API call using the generic makeApiCall method', async function () {
+    const response = await client.makeApiCall('get', '/addresses', {
+      page_size: 1,
+    });
+
+    expect(response.addresses.length).to.equal(1);
+    expect(response.addresses[0].object).to.equal('Address');
+  });
 });

test/cassettes/EasyPost_3093958733/makes-an-API-call-using-the-generic-makeApiCall-method_2342601902/recording.har

@@ -116,24 +116,42 @@ export default class EasyPost {
    * Adds a request hook to the EasyPost client. Useful for logging or debugging.
    */
   public addRequestHook(fn: (config: IEasyPostRequest) => void): void;
+
   /**
    * Removes a request hook from the EasyPost client.
    */
   public removeRequestHook(fn: (config: IEasyPostRequest) => void): void;
+
   /**
    * Clears all request hooks from the EasyPost client.
    */
   public clearRequestHooks(): void;
+
   /**
    * Adds a response hook to the EasyPost client. Useful for logging or debugging.
    */
   public addResponseHook(fn: (config: IEasyPostResponse) => void): void;
+
   /**
    * Removes a response hook from the EasyPost client.
    */
   public removeResponseHook(fn: (config: IEasyPostResponse) => void): void;
+
   /**
    * Clears all response hooks from the EasyPost client.
    */
   public clearResponseHooks(): void;
+
+  /**
+   * Make an API call to the EasyPost API.
+   *
+   * This public, generic interface is useful for making arbitrary API calls to the EasyPost API that
+   * are not yet supported by the client library's services. When possible, the service for your use case
+   * should be used instead as it provides a more convenient and higher-level interface depending on the endpoint.
+   */
+  public makeApiCall(
+    method: 'get' | 'post' | 'put' | 'patch' | 'del',
+    endpoint: string,
+    params?: Record<string, any>,
+  ): Promise<Record<string, any>>;
 }