---
title: "Check retirements status"
method: POST
path: "/retirements/account/{AccountIdentifier}/action/check-status"
tags: ["Retirements"]
---

# Check retirements status

`POST /retirements/account/{AccountIdentifier}/action/check-status`

## Request

- Base URL: `https://sandbox.preprod.connect.xpansiv.com/app/api/v1`
- URL: `https://sandbox.preprod.connect.xpansiv.com/app/api/v1/retirements/account/{AccountIdentifier}/action/check-status`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/xpansiv/apis/xpansiv-connect-api/docs/retirements/account/:AccountIdentifier/action/check-status/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `AccountIdentifier` string, required

## Request body

- object
  - `retirementIdentifiers` string[]

## Response `200`

Retirements

- object
  - `retirementStatuses` object[]
    - `status` string: Status of the retirement. Ref.Data.RETIREMENT_STATUS
    - `identifier` string: The retirement identifier.
    - `externalIdentifier` string: External retirement identifier, if provided.
    - `registryTransferIdentifier` string: Retirement identifier supplied by the registry.

## Other responses

- `400`: Bad request
- `401`: Not authorized error
- `500`: Internal server error

---

[API](https://skmtc.dev/xpansiv/apis/xpansiv-connect-api.md) - [All operations](https://skmtc.dev/xpansiv/apis/xpansiv-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xpansiv/apis/xpansiv-connect-api/revisions/01c1f2c4ec1e?raw)