---
title: "POST /shares"
method: POST
path: "/shares"
---

# POST /shares

`POST /shares`

Retrieves the resource shares associated with an account. Use the filter parameter to retrieve a specific subset of the shares.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Request body

- object
  - `resourceOwner` 'SELF' | 'OTHER', required — The account that owns the resource shares.
  - `filter` object — Use filters to return a subset of resources. You can define filters for specific parameters, such as the resource status.
    - `resourceArns` String[] — Filter based on the Amazon Resource Number (ARN) of the resource. You can specify up to 10 values.
    - `status` ShareStatus[] — Filter based on the resource status. You can specify up to 10 values.
    - `type` ShareResourceType[] — The type of resources to be filtered. You can specify one or more of the resource types.

## Response `200`

Success

- ListSharesResponse
  - `shares` ShareDetails[], required — The shares available and their metadata details.
    - `shareId` string — The ID of the resource share.
    - `resourceArn` string — The Arn of the shared resource.
    - `resourceId` string — The ID of the shared resource.
    - `principalSubscriber` string — The principal subscriber is the account that is sharing the resource.
    - `ownerId` string — The account ID for the data owner. The owner creates the resource share.
    - `status` 'PENDING' | 'ACTIVATING' | 'ACTIVE' | 'DELETING' | 'DELETED' | 'FAILED' — The status of the share.
    - `statusMessage` string — The status message for a resource share. It provides additional details about the share status.
    - `shareName` string — The name of the resource share.
    - `creationTime` string, date-time — The timestamp of when the resource share was created.
    - `updateTime` string, date-time — The timestamp of the resource share update.
  - `nextToken` string — Next token returned in the response of a previous ListSharesResponse call. Used to get the next page of results.

## Other responses

- `480` — InternalServerException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ConflictException
- `485` — ResourceNotFoundException
- `486` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/omics.md) · [All operations](https://skmtc.net/aws/apis/omics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/omics/versions/e9df1bcc0813/schema)