# Get Transfer Requests

This endpoint retrieves a list of transfer requests.
You can filter by `status`, `reviewer`, and other criteria, and returns a paginated list of `TransferRequest` objects.

Endpoint: GET /api/v1/transfer-requests/
Version: Version: 970cd0fc
Security: CodeBearer

## Security:

  - `CodeBearer` (unknown)
    oauth2 scopes: transfers.read

## Query parameters:

  - `status_filter[]` (any)

  - `reviewer_filter[]` (any)

  - `filter[]` (any)

  - `exclude_creator_filter[]` (any)

  - `cursor` (any)

  - `limit` (any)

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `prev_page` (any)

  - `next_page` (any)

  - `items` (array, required)

  - `items.id` (string, required)

  - `items.team_id` (string, required)

  - `items.created_by_user` (object, required)

  - `items.created_by_user.user_id` (string, required)

  - `items.created_by_user.first_name` (string, required)

  - `items.created_by_user.last_name` (string, required)

  - `items.created_by_user.active` (boolean, required)

  - `items.created_by_user.role` (string, required)
    Enum: "MAKER", "CHECKER", "VIEWER"

  - `items.created_at` (string, required)

  - `items.reviewed_by_user` (any)

  - `items.reviewed_at` (any)

  - `items.denial_reason` (any)

  - `items.denial_other_memo` (any)

  - `items.status` (string, required)
    Enum: "UNDER_REVIEW", "APPROVED", "PROCESSING", "PROCESSED", "REJECTED", "CANCELED", "DENIED"

  - `items.transfer` (any, required)

  - `items.transfer.id` (string, required)

  - `items.transfer.type` (string, required)

  - `items.transfer.counterparty_id` (string, required)

  - `items.transfer.origin_pocket_id` (string, required)

  - `items.transfer.amount` (object, required)

  - `items.transfer.amount.type` (string, required)

  - `items.transfer.amount.amount` (object, required)

  - `items.transfer.amount.amount.value` (integer, required)
    USD values are always in cents.

  - `items.transfer.amount.amount.currency` (string, required)

  - `items.transfer.amount.amount.formatted` (string)

  - `items.transfer.description` (any)

  - `items.transfer.details` (any, required)

  - `items.transfer.details.type` (string, required)

  - `items.transfer.details.destination_counterparty_id` (string, required)

  - `items.transfer.details.destination_pocket_id` (string, required)

  - `items.transfer.details.transfer_type` (any)

  - `items.transfer.end_to_end_identification` (any)

  - `items.reviewers` (array, required)

  - `items.reject_reason` (any)

  - `object_type` (string)

## Response 422:

  - `422` (unknown)
    Validation Error

## 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)