---
title: "Get Stripe onboarding link"
method: GET
path: "/api/apps/{app_id}/payments/stripe/sandbox/claim-url"
---

# Get Stripe onboarding link

`GET /api/apps/{app_id}/payments/stripe/sandbox/claim-url`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns a link to claim a [sandbox](/developers/references/apps-api/sections/payments-stripe#from-sandbox-to-live) or resume an unfinished activation.

This call checks Stripe for the sandbox's current state and updates the stored record if it's out of date. It also renews the link itself if the stored one expired.

Requires write access to the app. Workspace viewers cannot call this operation.

## Path parameters

- `app_id` string, required — ID of the Base44 app.

## Response `200`

Successful Response

- ClaimUrlResponse — Claim URL response.
  - `claim_url` string, nullable, required — Stripe onboarding link, or `null` when no link is available. Treat this link as a credential.
  - `is_claimable` boolean, required — Whether the returned link starts a claim. A link that resumes activation of an already claimed sandbox returns `false`.
  - `no_link_reason` 'already_active' | 'sandbox_expired' | 'unavailable', nullable — Reason no link is returned. `already_active` means the account already finished activation, so there's nothing left to claim. `sandbox_expired` means an unclaimed sandbox passed its 60-day window. `unavailable` covers every other case, including no sandbox at all. Otherwise `null`, when a link is returned. Defaults to `null`.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — The credential is not permitted or you don't have the required app access. A missing app also fails the app access check.
- `404` — No Stripe sandbox exists or the app is outside the credential grant.
- `409` — The workspace requires an unlocked SSO session.

## Changes

> 18 revisions in range; 1 not diffed.

- **2026-09-16** `ca10c5ce328c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/payments/stripe/sandbox/claim-url/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/28fc82924122?raw)
