---
title: "Get Status Of A Request"
method: GET
path: "/gw/api/v1/requests/{requestId}/status"
tags: ["accountManagementUtilities"]
---

# Get Status Of A Request

`GET /gw/api/v1/requests/{requestId}/status`

Returns status for account management request<br><br>**Scope**: `accounts.read`<br>**Security Policy**: `HTTPS`

## Path parameters

- `requestId` integer, required

## Query parameters

- `type` 'response' | 'update', required

## Response `200`

Returns status for account management request

- union
  - AmRequestStatusResponse
    - `requestId` string
    - `requestType` string
    - `status` string
    - `message` string
    - `acctId` string
  - StatusResponse
    - `requestId` integer
    - `dateSubmitted` string, date-time
    - `fileData` FileData
      - `data` FileDataData
      - `name` string

## Other responses

- `400` — Returns error description representing bad request
- `401` — Returns error description representing access issue
- `403` — Returns error description representing access issue
- `500` — Returns error description representing internal server error

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)
