---
title: "Get all MerQube portfolio_handler."
method: GET
path: "/target_portfolio_handler"
tags: ["portfolio_handler"]
---

# Get all MerQube portfolio_handler.

`GET /target_portfolio_handler`

## Request

- Base URL: `https://api.merqube.com`
- URL: `https://api.merqube.com/target_portfolio_handler`
- Auth: none declared
- TypeScript: <https://skmtc.dev/merqube/apis/merqube-api/docs/target_portfolio_handler/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all MerQube portfolio_handler.

## Query parameters

- `filter` string
- `ids` string
- `name` string
- `names` string
- `namespace` string
- `fields` string
- `debug` 'true'
- `format` 'csv'

## Response `200`

200 response

- object
  - `error_codes` ErrorCodes
    - `code` string
    - `message` string
  - `results` TargetPortfolioHandlerPatchPutGet[]
    - `auto_select` boolean: If true, the handler will automatically select the last valid portfolio for an effective timestamp
    - `eod_final_portfolio_lock_enabled` boolean: If true, finalized EOD target portfolios are locked after final selection.
    - `eod_status_patch_allowed` boolean: If false, clients cannot PATCH or DELETE the status of EOD target portfolios. MerQube internal callers can still update status so validation and auto-finalization keep working.
    - `event_notification_config` object
      - `FAILED_VALIDATION` TargetPortfolioHandlerNotificationConfig
        - `diss_destinations` DisseminationDestinations
          - `email_dissapi_configs` object[]
            - `bcc_list` string[]
            - `cc_list` string[]
            - `content` string
            - `email_list` string[]
            - `file_keys` string[]
            - `recipient_list` string[], required
            - `subject` string, required
          - `s3_dissapi_configs` object[]
            - `bucket` string, required
            - `file_keys` string[], required
            - `key_prefix` string, required
          - `sftp_dissapi_configs` object[]
            - `file_keys` string[], required
            - `sftp_ids` string[], required
        - `file_name_format` string
      - `FINAL` TargetPortfolioHandlerNotificationConfig
        - `diss_destinations` DisseminationDestinations
          - `email_dissapi_configs` object[]
            - `bcc_list` string[]
            - `cc_list` string[]
            - `content` string
            - `email_list` string[]
            - `file_keys` string[]
            - `recipient_list` string[], required
            - `subject` string, required
          - `s3_dissapi_configs` object[]
            - `bucket` string, required
            - `file_keys` string[], required
            - `key_prefix` string, required
          - `sftp_dissapi_configs` object[]
            - `file_keys` string[], required
            - `sftp_ids` string[], required
        - `file_name_format` string
      - `PASSED_VALIDATION` TargetPortfolioHandlerNotificationConfig
        - `diss_destinations` DisseminationDestinations
          - `email_dissapi_configs` object[]
            - `bcc_list` string[]
            - `cc_list` string[]
            - `content` string
            - `email_list` string[]
            - `file_keys` string[]
            - `recipient_list` string[], required
            - `subject` string, required
          - `s3_dissapi_configs` object[]
            - `bucket` string, required
            - `file_keys` string[], required
            - `key_prefix` string, required
          - `sftp_dissapi_configs` object[]
            - `file_keys` string[], required
            - `sftp_ids` string[], required
        - `file_name_format` string
      - `PAST_DEADLINE` TargetPortfolioHandlerNotificationConfig
        - `diss_destinations` DisseminationDestinations
          - `email_dissapi_configs` object[]
            - `bcc_list` string[]
            - `cc_list` string[]
            - `content` string
            - `email_list` string[]
            - `file_keys` string[]
            - `recipient_list` string[], required
            - `subject` string, required
          - `s3_dissapi_configs` object[]
            - `bucket` string, required
            - `file_keys` string[], required
            - `key_prefix` string, required
          - `sftp_dissapi_configs` object[]
            - `file_keys` string[], required
            - `sftp_ids` string[], required
        - `file_name_format` string
      - `PENDING_VALIDATION` TargetPortfolioHandlerNotificationConfig
        - `diss_destinations` DisseminationDestinations
          - `email_dissapi_configs` object[]
            - `bcc_list` string[]
            - `cc_list` string[]
            - `content` string
            - `email_list` string[]
            - `file_keys` string[]
            - `recipient_list` string[], required
            - `subject` string, required
          - `s3_dissapi_configs` object[]
            - `bucket` string, required
            - `file_keys` string[], required
            - `key_prefix` string, required
          - `sftp_dissapi_configs` object[]
            - `file_keys` string[], required
            - `sftp_ids` string[], required
        - `file_name_format` string
      - `SELECTED` TargetPortfolioHandlerNotificationConfig
        - `diss_destinations` DisseminationDestinations
          - `email_dissapi_configs` object[]
            - `bcc_list` string[]
            - `cc_list` string[]
            - `content` string
            - `email_list` string[]
            - `file_keys` string[]
            - `recipient_list` string[], required
            - `subject` string, required
          - `s3_dissapi_configs` object[]
            - `bucket` string, required
            - `file_keys` string[], required
            - `key_prefix` string, required
          - `sftp_dissapi_configs` object[]
            - `file_keys` string[], required
            - `sftp_ids` string[], required
        - `file_name_format` string
      - `UNSELECTED` TargetPortfolioHandlerNotificationConfig
        - `diss_destinations` DisseminationDestinations
          - `email_dissapi_configs` object[]
            - `bcc_list` string[]
            - `cc_list` string[]
            - `content` string
            - `email_list` string[]
            - `file_keys` string[]
            - `recipient_list` string[], required
            - `subject` string, required
          - `s3_dissapi_configs` object[]
            - `bucket` string, required
            - `file_keys` string[], required
            - `key_prefix` string, required
          - `sftp_dissapi_configs` object[]
            - `file_keys` string[], required
            - `sftp_ids` string[], required
        - `file_name_format` string
    - `intraday_auto_select` boolean: If true, the handler will automatically select the last valid intraday portfolio for an effective timestamp
    - `intraday_final_portfolio_lock_enabled` boolean: If true, finalized intraday target portfolios are locked after final selection.
    - `intraday_selection_window` TimestampWindow
      - `end_ts` string, required: the time of day of the deadline
      - `start_ts` string: the time of day of the deadline
      - `tzinfo` string: Timezone of the window
    - `intraday_status_patch_allowed` boolean: If false, clients cannot PATCH or DELETE the status of INTRADAY target portfolios. MerQube internal callers can still update status so validation and auto-finalization keep working.
    - `intraday_validation_window` TimestampWindow
      - `end_ts` string, required: the time of day of the deadline
      - `start_ts` string: the time of day of the deadline
      - `tzinfo` string: Timezone of the window
    - `intraday_validator_fn` string
    - `name` string, required
    - `namespace` string, required: the calling user must have permission to this namespace to create the handler in this namespace
    - `selection_window` TimestampWindow
      - `end_ts` string, required: the time of day of the deadline
      - `start_ts` string: the time of day of the deadline
      - `tzinfo` string: Timezone of the window
    - `validation_window` TimestampWindow
      - `end_ts` string, required: the time of day of the deadline
      - `start_ts` string: the time of day of the deadline
      - `tzinfo` string: Timezone of the window
    - `validator_fn` string
    - `id` string, required
    - `status` Status, required
      - `created_at` string
      - `created_by` string
      - `last_modified` string, required
      - `last_modified_by` string
      - `locked_after` string, date-time: If this is set (non null), the manifest is locked for all edits to any other field after this timestamp. A PUT/PATCH may be used to first unlock the manifest, by setting this field (to a max of one hour in the future), or to `null` again, to make other edits.

---

[API](https://skmtc.dev/merqube/apis/merqube-api.md) - [All operations](https://skmtc.dev/merqube/apis/merqube-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merqube/apis/merqube-api/revisions/20f47ca36587?raw)
