ReturnGO API Overview

The ReturnGO API enables you to seamlessly integrate with any system or process in your eCommerce stack. This gives you the flexibility to choose the most suitable tools and processes for your business needs. 

What is an API?

An API (Application Programming Interface) is a set of rules and protocols that allows different software applications to communicate and interact with each other.

The ReturnGO API is based on the REST API paradigm. You can review the full API documentation here.

By leveraging the API's endpoints and functionalities, you can connect various parts of the returns process including generating return shipping labels, validating returned items, and automating certain status updates.

You can leverage the ReturnGO API by using it when developing an application, or by using a no-code tool like Make or Zapier to build a workflow.

How to Access the API

To access the API, get your API key from the Settings > Integrations > API page. 

This secret key serves as an authentication mechanism, ensuring that only authorized users can access the API.

Note: Make sure you add the authentication headers (API key and store name) to each API call, as defined in the API documentation.

Rate Limits

The default rate limit is 2000 calls per day and 100 calls per second. If you need a higher limit, contact ReturnGO support.

Tip: If you receive a 429 status code, you’ve reached the limit.

Multiple Stores

With ReturnGO, you can manage multiple stores using a single API key.

The API key is per store owner, as opposed to per store. The same key can be used for multiple stores if you see them in the store selector in your dashboard - otherwise, you’ll need to create a separate key for the other owner/store.

What Can You Use the API For?

You can use the ReturnGO API to streamline your workflow by creating custom integrations with your WMS, shipping, and return pickup systems, as well as your storefront and more.

Here are some examples of ways you can use the ReturnGO API:

1. WMS Integration

In order to sync between your warehouse and returns teams, you can use the API to build a custom integration with your warehouse management system, 3PL, or ERP. 

Using the API, you can update the WMS when an RMA has been created, and then update ReturnGO when the item has been validated and processed at the warehouse. 

Combined with approval, refund, and exchange automation, this enables you to fully automate the entire returns process regardless of the WMS you use, leaving only exceptions to be handled manually.

2. Shipping Integration

You can build custom shipping integrations using the API so that when an RMA is created, you can trigger your shipping carrier to generate a return shipping label that’s automatically sent to your customer as part of the approval email, along with the packing slip if configured.

3. Return Pickup Integration

The ReturnGO API enables you to integrate with third-party pickup services to provide return pickups for your customers, including generating a return pickup label when an RMA is created.

4. Storefront Integration

You can use the API to display RMA history and information on a customized customer account page.

ReturnGO's API enables you to connect virtually any way you like, enabling full automation and maximum flexibility in your return workflow.

How to Test the API

To test the API:

  1. Go to the API documentation swagger page and click on AUTHORIZE.

2. Paste your API key into the Value field.


4. Click on an endpoint that you want to test.
5. Click TRY IT OUT. The fields will become editable.
6. Fill in the required fields.

7. Click EXECUTE.

Below, under Responses, you can see whether the connection worked, and the results.