Skip to main content

Documentation Index

Fetch the complete documentation index at: https://parabola.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Loop Returns is a returns management platform for e-commerce brands, primarily those running on Shopify, that turns the returns experience into an opportunity for revenue retention through exchanges, bonus credits, and self-service workflows. Connecting Loop Returns to Parabola lets ops, customer-experience, and finance teams pull return data into the same flows used for inventory, accounting, and reporting, without manual exports or engineering work.

​
Pull from Loop Returns

The Pull from Loop Returns step retrieves return data from the Loop Returns API. Use it to bring detailed returns, return-level shipping data, and ASN tracking into your flow for downstream transformation, joining, and reporting.

​
How to authenticate

Loop Returns uses API key authentication.
1
Generate your API key in Loop Returns:
  • Log in to your Loop Returns admin dashboard at https://admin.loopreturns.com
  • Go to Returns Management > Tools & integrations > Developer Tools
  • In the API keys section, click Generate API key
  • Give your key a descriptive name (e.g., “Parabola Integration”)
  • Select the Returns scope — required to access return data
  • Copy your API key and store it securely
2
Connect in Parabola:
  • Add a Pull from Loop Returns step to your flow
  • Click Authorize and paste your API key when prompted

​
Available data

Using the Pull from Loop Returns step, you can pull comprehensive return and shipping data:
  • Detailed Returns List: Full return records including order information, customer details, line items with product and pricing data, exchange information, refund amounts, gift card details, label tracking, return methods, addresses, timestamps, and return states. Filter by date ranges (created or updated) and return status (open, closed, cancelled, expired, or review).
  • Return Details: In-depth information on a specific return by return ID, order ID, or order name. Includes complete line item details with conditions and dispositions, exchange orders, labels with carrier and tracking data, refund processing information, Shopify refund objects, and all timestamps.
  • Advanced Shipping Notice (ASN): Package-level tracking data including return line items, carrier details, tracking numbers and statuses, label rates and URLs, shipping destinations, product information (SKU, barcode, title), pricing and currency, order and return references, delivery dates, return reasons and outcomes, restock status, and consolidation tracking for multi-item shipments.

​
Common use cases

  • Reconcile returns across systems: Join Loop returns with Shopify orders and 3PL data from ShipBob or ShipHero to confirm return statuses, refunds, and inventory adjustments line up.
  • Monitor return rates by product or SKU: Combine Loop data with product catalogs from Shopify or Cin7 to identify quality issues, sizing problems, or SKUs with high return rates that need attention.
  • Track carrier SLAs on returns: Analyze time from return creation to delivery against carriers like UPS, FedEx, and DHL, identifying bottlenecks and the carriers with the best return performance.
  • Generate finance-ready returns dashboards: Push reconciled return volumes, exchange-vs-refund rates, and revenue retained into Google Drive, Smartsheet, or accounting systems like NetSuite and QuickBooks Online.
  • Audit return shipping costs: Compare Loop’s label rates against actual carrier invoices to catch billing discrepancies and overcharges before paying.
  • Trigger ops alerts: Send a Slack message when return volumes spike, when high-value returns are initiated, or when a return stays “open” beyond your acceptable threshold.

​
Tips for using Parabola with Loop Returns

  • Schedule your flow to match your reporting cadence. Hourly for ops alerts, daily for finance reconciliation, weekly for product-quality reviews.
  • Use date filters strategically. The Detailed Returns List defaults to the last 24 hours if no dates are provided. For historical analysis, specify both from and to dates (maximum 120-day range per request).
  • Filter by return state. Use “open” for active returns, “closed” for completed returns, or “review” for returns flagged for manual inspection. Pulling everything at once is rarely what you need.
  • Combine with Shopify and 3PL data. Returns reporting is most useful when joined to the original order and the warehouse processing record, so include those data sources in the same flow.
  • Add alerts for outliers. Use a Filter rows step to flag returns above a value threshold, returns stuck in “open” past a target SLA, or sudden volume spikes.
  • Export summaries to BI tools. Push reconciled data into Snowflake, BigQuery, or your dashboard tool for executive reporting.

​
FAQ

​
Can I push data back into Loop Returns?

The Pull from Loop Returns step is read-only. To write back to Loop (for example, updating a return status or creating an exchange), use a Send to an API step pointed at the relevant Loop endpoint with your API key in the Authorization header.

​
What’s the date-range limit on the Detailed Returns List?

Loop’s API caps the date range at 120 days per request. For longer historical pulls, run multiple Parabola flows or chain multiple Pull from Loop Returns steps with different date windows and stack the results.

​
Can I pull return reasons and dispositions?

Yes. The Return Details endpoint includes line-item-level conditions, dispositions, and return reasons, which you can join back to product or order data downstream.
With Loop Returns and Parabola connected, the returns data that used to live in CSV exports flows directly into the dashboards, reconciliations, and alerts your team already uses.
Last modified on May 18, 2026