# Get Pocket

Retrieve a single Pocket for a given `pocket_id.`

Endpoint: GET /api/v2/pockets/{pocket_id}/
Version: Version: cf52545e
Security: HTTPBearer

## Path parameters:

  - `pocket_id` (string, required)

## Query parameters:

  - `omit[]` (any)

  - `valuation_type` (any)

## Header parameters:

  - `x-jiko-idempotency` (string, required)

  - `x-jiko-signature` (string, required)

## Response 200 fields (application/json):

  - `id` (string, required)
    ID of the pocket

  - `pocket_name` (string, required)
    Pocket name

  - `portfolio` (any)
    Total liquid cash and holdings

  - `portfolio.securities` (array, required)

  - `portfolio.securities.quantity` (integer, required)
    Number of securities

  - `portfolio.securities.market_value` (object, required)

  - `portfolio.securities.market_value.value` (integer, required)
    USD values are always in cents.

  - `portfolio.securities.market_value.currency` (string, required)

  - `portfolio.securities.market_value.formatted` (string)

  - `portfolio.securities.cusip` (string, required)
    CUSIP number of security

  - `portfolio.securities.jiko_mark_price` (string, required)

  - `portfolio.securities.description` (string, required)
    A description of the security

  - `portfolio.securities.type` (string, required)

  - `portfolio.securities.maturity_date` (string, required)
    Due date of the fixed income instrument

  - `portfolio.all_time_earnings` (any)
    All time portfolio earnings. Use of this field is discouraged, as it will be removed in a future release. Please use the [Get Earnings](/products/partner-api/reference/pockets/get-earnings-v2) endpoint instead.

  - `portfolio.fees` (array, required)
    Any outstanding fees

  - `portfolio.fees.type` (string, required)

  - `portfolio.liquidation_value_t1` (any)
    Available liquid amount at T+1

  - `portfolio.pricing_timestamp` (any)
    Timestamp at which `total_value` was priced. Populated for pockets backed by accounts with the `real_time_yield` attribute when at least one underlying CUSIP holding has real-time pricing; `null` otherwise.

  - `portfolio.appreciation_per_second` (any)
    Rate at which `total_value` accrues per second, in USD cents. Combined with `pricing_timestamp`, allows interpolating the displayed total value forward as `total_value + appreciation_per_second × (now - pricing_timestamp)`. Populated for pockets backed by accounts with the `real_time_yield` attribute when at least one underlying CUSIP holding has real-time pricing; `null` otherwise.

  - `status` (string, required)
    Pocket status
    Enum: "PENDING", "OPEN", "FROZEN", "CLOSED"

  - `attributes` (array)

  - `deposit_strategy_id` (string, required)
    Pocket deposit trading strategy ID (Example: UST-4W)

  - `reinvestment_strategy_id` (any, required)
    Pocket reinvestment trading strategy ID (Example: UST-4W)

  - `type` (any)
    Pocket type

  - `customer_id` (string, required)
    The ID of the customer this pocket belongs to

  - `object_type` (string, required)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)