> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get pending ownership transfer
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns the app's pending ownership transfer, or `null` in `transfer` when it has none.
A transfer starts in the builder, when the app's owner or a workspace admin invites a new owner by email. The recipient gets an email with a link, and the transfer completes only once they sign in and accept it. Nothing about the app changes until then. An invitation expires 7 days after it's sent. An expired invitation isn't returned. Send it again with [Resend ownership transfer](/api-reference/resend-ownership-transfer), or withdraw it with [Cancel ownership transfer](/api-reference/cancel-ownership-transfer).
You need to own the app or be an owner or admin of its workspace. A workspace admin who doesn't own the app also needs an Enterprise workspace or approved partner status. For a transfer to someone outside the workspace, the owner has to be a workspace owner or admin too, with the same Enterprise or partner requirement.
This is limited to 120 requests a minute per caller. Some workspaces have a different limit.
This endpoint accepts a personal API key. A read-only key is refused, and workspace API keys are not accepted.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/ownership/transfer/pending
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/apps/{app_id}/ownership/transfer/pending:
get:
summary: Get pending ownership transfer
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns the app's pending ownership transfer, or `null` in `transfer`
when it has none.
A transfer starts in the builder, when the app's owner or a workspace
admin invites a new owner by email. The recipient gets an email with a
link, and the transfer completes only once they sign in and accept it.
Nothing about the app changes until then. An invitation expires 7 days
after it's sent. An expired invitation isn't returned. Send it again
with [Resend ownership
transfer](/api-reference/resend-ownership-transfer), or withdraw it with
[Cancel ownership transfer](/api-reference/cancel-ownership-transfer).
You need to own the app or be an owner or admin of its workspace. A
workspace admin who doesn't own the app also needs an Enterprise
workspace or approved partner status. For a transfer to someone outside
the workspace, the owner has to be a workspace owner or admin too, with
the same Enterprise or partner requirement.
This is limited to 120 requests a minute per caller. Some workspaces
have a different limit.
This endpoint accepts a personal API key. A read-only key is
refused, and workspace API keys are not accepted.
operationId: get_pending_transfer_api_apps__app_id__ownership_transfer_pending_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app.
title: App Id
description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
responses:
'200':
description: The app's pending transfer, if any.
content:
application/json:
schema:
$ref: '#/components/schemas/PendingOwnershipTransferResponse'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You can't manage ownership transfers for this app, your API key is
read-only, or you used a workspace API key.
'404':
description: >-
The app doesn't exist, or it's outside the workspace or apps your
API key is scoped to.
'429':
description: Rate limit reached. Retry later.
components:
schemas:
PendingOwnershipTransferResponse:
properties:
transfer:
anyOf:
- $ref: '#/components/schemas/PendingOwnershipTransfer'
- type: 'null'
description: The pending transfer, or `null` when the app has none.
example:
app_id: 6820f3a4e7b91d003c45a1f2
expires_at: '2026-10-05T09:23:41.512000Z'
id: 68d4b1e9c2a7f3001e5b8c40
new_owner_email: jane@acme.com
status: pending
type: object
required:
- transfer
title: PendingOwnershipTransferResponse
description: The app's pending ownership transfer, if it has one.
PendingOwnershipTransfer:
properties:
id:
type: string
title: Id
description: ID of the ownership transfer.
example: 68d4b1e9c2a7f3001e5b8c40
app_id:
type: string
title: App Id
description: ID of the app being transferred.
example: 6820f3a4e7b91d003c45a1f2
new_owner_email:
type: string
title: New Owner Email
description: Email address the transfer invitation was sent to.
example: jane@acme.com
status:
type: string
title: Status
description: >-
Either `pending`, while the invitation waits for the recipient, or
`accepting`, while the recipient's acceptance is being applied.
example: pending
expires_at:
type: string
title: Expires At
description: >-
When the invitation expires, as a UTC timestamp in ISO 8601 format.
The recipient can't accept it after that.
example: '2026-10-05T09:23:41.512000Z'
type: object
required:
- id
- app_id
- new_owner_email
- status
- expires_at
title: PendingOwnershipTransfer
description: An ownership transfer waiting for its recipient to accept it.
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````