# List the offers of ownership for you

> The ownership_transfers.list_mine operation: GET /api/v1/ownership_transfers/mine in the REST API and the ownership_transfers_list_mine tool in the MCP server.

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`](https://ownrecord.io/docs/reference/errors.md#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](https://ownrecord.io/docs/reference.md#common-errors): [`validation_failed`](https://ownrecord.io/docs/reference/errors.md#validation_failed), [`api_version_unsupported`](https://ownrecord.io/docs/reference/errors.md#api_version_unsupported), [`authentication_required`](https://ownrecord.io/docs/reference/errors.md#authentication_required), [`api_key_invalid`](https://ownrecord.io/docs/reference/errors.md#api_key_invalid), [`resource_not_found`](https://ownrecord.io/docs/reference/errors.md#resource_not_found), [`dry_run_not_supported`](https://ownrecord.io/docs/reference/errors.md#dry_run_not_supported), [`rate_limited`](https://ownrecord.io/docs/reference/errors.md#rate_limited), [`internal_error`](https://ownrecord.io/docs/reference/errors.md#internal_error).