Redirect List

🔒

Requires read_shop_navigation access scope. More access scope

The Redirect List API retrieves a list of all redirects configured in your store, including their details and statuses.

This API is especially useful for:

  1. Viewing all configured redirects in one place.
  2. Monitoring and managing URL redirections in your store.
  3. Debugging or verifying multiple redirect entries.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Successful Response

FieldTypeDescriptionExample
countintegerThe total number of redirects in the store.2
redirectsarrayA list of redirect objects.See below for redirect fields.
redirects.idstringUnique identifier for the redirect.373043170117713580
redirects.store_idintegerID of the store where the redirect is configured.633130
redirects.statusstringStatus of the redirect.open
redirects.from_urlstringThe original URL specified for redirection./collections/hot-selling1
redirects.redirect_urlstringThe target URL specified for the redirection./collections/test1567

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorString "store is not active"Indicates an error encountered during the process

Error Detail

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!