---
title: "Fetch share"
method: GET
path: "/shares/{id}"
tags: ["Shares"]
deprecated: true
---

# Fetch share

`GET /shares/{id}`

> **Deprecated.**

<!-- theme: info -->
> This API is deprecated.
> Please read our [documentation](https://docs.kisi.io/api/how_to_guides/manage_access_rights/assign_access_rights/) about how to manage access rights.

## Path parameters

- `id` integer, required

## Response `200`

OK

- object
  - `id` integer, required — The ID of the share
  - `resource_type` 'Share', required — The resource type of the share
  - `created_at` string, date-time, required — When the share was created
  - `updated_at` string, date-time, required — When the share was updated
  - `email` string, email, required — The email of the share's user. Cannot be changed once set
  - `notify` boolean, nullable, required — Whether an email should be sent when this share is created or updated
  - `role_id` 'manager' | 'basic', required — The role of the share
  - `valid_from` string, date-time, nullable, required — When the share starts to be valid at
  - `valid_until` string, date-time, nullable, required — When the share stops to be valid at
  - `group_id` integer, required — The group ID of the share
  - `group` object, required — The group of the share
    - `id` integer, required — The ID of the group
    - `resource_type` 'Group', required — The resource type of the group
    - `name` string, required — The name of the group
  - `member_id` integer, required — The member ID of the share
  - `member` object, required — The member of the share
    - `id` integer, required — The ID of the member
    - `resource_type` 'Member', required — The resource type of the member
    - `name` string, required — The name of the member
  - `place_id` integer, nullable, required — The place ID of the share
  - `place` object — The place of the share
    - `id` integer, required — The ID of the place
    - `resource_type` 'Place', required — The resource type of the place
    - `name` string, required — The name of the place
  - `user_id` integer, required — The user ID of the share
  - `user` object, required — The user of the share
    - `id` integer, required — The ID of the user
    - `resource_type` 'User', required — The resource type of the user
    - `email` string, email, required — The email of the user.
    - `name` string, required — The name of the user
  - `created_by_type` 'null' | 'User' | 'MarketplaceInstallation', nullable, required — The created_by type of the share
  - `created_by_id` integer, nullable, required — The created_by ID of the share
  - `created_by` union — The created_by of the share
    - object
      - `id` integer, required — The ID of the user
      - `resource_type` 'User', required — The resource type of the user
      - `email` string, email, required — The email of the user.
      - `name` string, required — The name of the user
    - object
      - `id` integer, required — The ID of the marketplace installation
      - `resource_type` 'MarketplaceInstallation', required — The resource type of the marketplace installation
  - `lock_id` unknown, required
  - `apply_to_place` false, required
  - `role` string, nullable, required
  - `issued_to_id` integer, nullable, required — The ID of the share's user
  - `issued_to_email` string, email, required — The email of the share's user
  - `issued_by_id` integer, nullable, required — The issued_by ID of the share
  - `issued_by` object — The issued_by of the share
    - `id` integer, required — The ID of the user
    - `resource_type` 'User', required — The resource type of the user
    - `email` string, email, required — The email of the user.
    - `name` string, required — The name of the user

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/kisi/apis/kisi-api.md) · [All operations](https://skmtc.dev/kisi/apis/kisi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kisi/kisi-api/revisions/998700ffff5a/schema)