List the offers of ownership for you

Lists the open offers of ownership addressed to you, with the organization and when each offer lapses. Accept one with ownership_transfers.accept.

Who can call it: any signed-in user.

At a glance

REST: GET /api/v1/ownership_transfers/mine
MCP tool: ownership_transfers_list_mine
Operation ID: ownership_transfers.list_mine
Scope: Platform
Permission: account:read
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Authentication: API key with the account:read scope
Since: M12

Request

Query parameters

This operation takes no query parameters.

Response

200 OK with a JSON object:

Field	Type	Description
`object`	`"list"`
`data`	array of object
`data[].orgId`	`org_…` ID
`data[].organization`	object
`data[].organization.slug`	string
`data[].organization.name`	string
`data[].fromUserId`	`usr_…` ID
`data[].expiresAt`	date-time

Examples

One offer

HTTP

GET /api/v1/ownership_transfers/mine
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "object": "list",
  "data": [
    {
      "orgId": "org_01m4tx5nj7ekd958x53w4bntcg",
      "organization": {
        "slug": "acme",
        "name": "Acme"
      },
      "fromUserId": "usr_01m4tx5nj8emwbyf7y9vcf47xa",
      "expiresAt": "2026-11-02T09:00:00.000Z"
    }
  ]
}

Errors

Code	HTTP status	When	What to do
`permission_denied`	403	The caller isn't a signed-in user.	Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: validation_failed, api_version_unsupported, authentication_required, api_key_invalid, resource_not_found, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Query parameters#

Response#

Examples#

One offer#

Errors#