---
title: "Verify the app proxy path"
description: "Check that the storefront answers the app proxy path the store-domain opt-in link uses. valid is true or false; it is null with password_protected true while the storefront password hides the answer."
url: https://docs.stoqapp.com/v2-reference/back-in-stock-app-proxy/verify-the-app-proxy-path/
api: "API v2 reference"
method: GET
path: "/back_in_stock/app_proxy/verify"
---

# Verify the app proxy path

`GET https://app.stoqapp.com/api/v2/external/back_in_stock/app_proxy/verify`

Check that the storefront answers the app proxy path the store-domain opt-in link uses. valid is true or false; it is null with password_protected true while the storefront password hides the answer.

**Note:** Read-only: nothing is saved. `path_prefix` must look like `/apps/&lt;suffix&gt;` or `/a/&lt;suffix&gt;`, as set in the app proxy settings in Shopify, or the call fails with 422 `invalid_params`. Check a path here before saving it as `optin.app_proxy_path_prefix` in [`PATCH /back_in_stock/settings/widget`](https://docs.stoqapp.com/v2-reference/back-in-stock-settings/update-widget-settings/): while `optin.custom_domain_enabled` is on, the double opt-in confirmation link is built from it. A store that doesn't answer within 5 seconds also gives `valid: false`. If you don't know the path, call [`GET /back_in_stock/app_proxy/detect`](https://docs.stoqapp.com/v2-reference/back-in-stock-app-proxy/detect-the-app-proxy-path/).

## Query parameters

- `path_prefix` (string, required): App proxy path to check, &quot;/apps/&lt;suffix&gt;&quot; or &quot;/a/&lt;suffix&gt;&quot;, as set in the Shopify app proxy settings.

## Returns

- `valid` (boolean, nullable): e.g. `true`
- `password_protected` (boolean): e.g. `true`

Rate limit: this call costs 1 point ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl "https://app.stoqapp.com/api/v2/external/back_in_stock/app_proxy/verify?path_prefix=string" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: the requested resource.

```json
{
  "valid": true,
  "password_protected": true
}
```

## 401

Missing or invalid `X-Auth-Token`.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "auth_invalid",
  "details": [
    {
      "code": "auth_invalid",
      "message": "Invalid API key",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 422

The request failed validation.

```json
{
  "errors": [
    "name is required"
  ],
  "code": "validation_failed",
  "details": [
    {
      "code": "validation_failed",
      "message": "name is required",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 429

Rate limited: cost-weighted per token (read 1, write 2; 360 points / 60s). Check `Retry-After`.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited",
  "details": [
    {
      "code": "rate_limited",
      "message": "Rate limit exceeded",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

