# Loop

Loop streamlines returns/exchanges. With KODIF, you can retrieve return details, manage allow/block lists, and access destinations—letting customers resolve returns while enforcing policy controls.

## Integration Actions

##### Loop - Create Allowlist Entry

Creates Allowlist Entry using Loop. Requires type and value and secondary_value. Returns confirmation of creation, including the new record’s ID and details.

##### Loop - Create Blocklist Entry

Creates Blocklist Entry using Loop. Requires type and value and secondary_value. Returns confirmation of creation, including the new record’s ID and details.

##### Loop - Create Deep Link to Order

Generates a direct link to a Loop Returns order page for customers to initiate returns or exchanges. This integration creates a secure, customer-specific deep link to an order within the Loop Returns platform. When customers need to return or exchange items, this tool generates a direct URL that takes them straight to their order details in Loop Returns, bypassing the need to manually search for their order. This streamlines the returns process and improves customer experience.

* * *

###### Parameters

- **order_name** ( _String_): The unique identifier or name of the order to link to. This can be in formats like “#1234567” or “1234567”. Example: “#1245678”.
- **customer_email** ( _String (email)_): The email address of the customer who placed the order. This is used for verification and security purposes. Example: “sarah.johnson@example.com”.

* * *

###### Output

Returns a JSON object containing a single **url** field with the generated deep link. This URL directs the customer to their specific order page within the Loop Returns portal where they can initiate returns, exchanges, or view return status.

Example Output:

```
{
  "url": "https://mystore.loopreturns.com/#/link/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

* * *

[Read Less](https://kodif.ai/blog/tool/loop/#)

##### Loop - Get All Destinations

Retrieves All Destinations using Loop. No inputs are required. Returns the requested data record(s) with all available details.

##### Loop - Get Allowlist Entry by ID

Retrieves Allowlist Entry by ID using Loop. Requires allow_item_id. Returns the requested data record(s) with all available details.

##### Loop - Get Allowlist Page

Retrieves Allowlist Page using Loop. Requires page. Returns the requested data record(s) with all available details.

##### Loop - Get Blocklist Entry by ID

Retrieves Blocklist Entry by ID using Loop. Requires blocked_item_id. Returns the requested data record(s) with all available details.

##### Loop - Get Blocklist Page

Retrieves Blocklist Page using Loop. Requires page. Returns the requested data record(s) with all available details.

##### Loop - Get Return Details

Retrieves detailed return information from Loop Returns using order or return identifiers. This integration connects to Loop Returns to fetch comprehensive details about a specific return request. You can look up return information using either an order ID, return ID, or order name. This helps support teams quickly access return status, refund amounts, shipping labels, customer details, and individual line item information for processing returns and answering customer inquiries.

* * *

###### Parameters

- **return_id** ( _Integer_): The unique identifier for a specific return request. Example: 123456.
- **order_id** ( _Integer_): The unique identifier for the original order. Example: 987654.
- **order_name** ( _String_): The order name/number from your e-commerce platform. Example: “FP-123141”.

_Note: At least one parameter is required to perform the lookup._

* * *

###### Output

Returns a comprehensive return object containing **id**, **state**, **total**, **refund**, **customer**, **order_name**, shipping **labels** with tracking numbers, and detailed **line_items** array with product information, SKUs, prices, return reasons, and outcomes. When no return is found, returns an error message stating “No returns originated from an order with this name.”

Example Output:

```
[{\
  "id": 101785420,\
  "type": "standard",\
  "state": "open",\
  "total": "56.60",\
  "refund": "56.60",\
  "currency": "USD",\
  "customer": "sarah.mitchell@example.com",\
  "customer_email": "sarah.mitchell@example.com",\
  "customer_first_name": "sarah",\
  "customer_last_name": "mitchell",\
  "order_name": "#942391",\
  "order_number": 941391,\
  "tracking_number": "9434636106023325941797",\
  "label_status": "delivered",\
  "created_at": "2026-02-19 12:46:58",\
  "updated_at": "2026-03-05 18:34:58",\
  "line_items": [{\
    "sku": "FCE-SPF-40U",\
    "title": "OS-01 FACE SPF BROAD SPECTRUM SPF 30+ PA+++",\
    "variant_title": "Untinted",\
    "price": "47.60",\
    "refund": "56.60",\
    "reason": "I only meant to order one of this product",\
    "parent_reason": "I ordered this by mistake",\
    "outcome": "default",\
    "returned_at": "2026-02-19 12:46:58"\
  }],\
  "labels": [{\
    "url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20260219/e8179ace12abf34afcaad25add1069810b.pdf",\
    "carrier": "USPS",\
    "tracking_number": "9434636106023325941797",\
    "status": "delivered"\
  }]\
}]\
```

* * *

[Read Less](https://kodif.ai/blog/tool/loop/#)

[See an example](https://kodif.ai/blog/tool/loop/#)

1. Ask the customer for the order number they want an update on
2. Once entered, Use @Loop – Get Return Details with order_name being the order number provided by the customer

## Integration Configuration

### Getting API Credentials

For information on getting the appropriate Integration credentials, visit the [Loop site directly.](https://docs.loopreturns.com/api-reference/authentication#api-key-authentication)