---
title: "Match redirect"
method: POST
path: "/v1/redirects"
tags: ["redirects"]
---

# Match redirect

`POST /v1/redirects`

Matches a redirect for a given URL

## Request body

- MatchRedirectBody
  - `url` string — The url to find a redirect for

## Response `200`

request successful

- MatchRedirect
  - `source` string, required — The source URL for the redirect
  - `target` string, required — The target URL for the redirect
  - `statusCode` integer, required — The status code for the redirect

## Other responses

- `401` — authentication failed
- `404` — there is no redirect for the requested url

## Changes

- **2026-07-17** `8cfa924ae703` — 1 warning, 4 info
  - removed the optional property `id` from the response with the `200` status
  - added the non-success response with the status `404`
  - the response property `source` became required for the status `200`
  - the response property `statusCode` became required for the status `200`
  - …1 more
- **2023-08-21** `beabe2149947` — 1 info
  - api operation id `match-redirects` was added
- **2023-08-06** `302b7c443b51` — 3 breaking, 3 info
  - the response property `source` became optional for the status `200`
  - the response property `statusCode` became optional for the status `200`
  - the response property `target` became optional for the status `200`
  - api operation id `match-redirects` removed and replaced with ``
  - …2 more

[Change history](https://skmtc.dev/scayle/apis/storefront-api-documentation/changes/v1/redirects/post.md)

---

[API](https://skmtc.dev/scayle/apis/storefront-api-documentation.md) · [All operations](https://skmtc.dev/scayle/apis/storefront-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scayle/storefront-api-documentation/revisions/8cfa924ae703/schema)