---
title: "GET Purpose List"
method: GET
path: "/v1/client/accounts/purpose"
---

# GET Purpose List

`GET /v1/client/accounts/purpose`

The Get Purpose List API allows the API User to retrieve the Purpose and Sub-purpose for the international remittence. The purpose of the transaction determines the Transfer code under which the transaction is to be considered.

## Headers

- `api-key` string, required
- `auth-key` string, required
- `userId` string, required

## Response `200`

200

- object
  - `status` integer
  - `message` string
  - `data` object[]
    - `purposeId` string
    - `title` string
    - `slug` string
    - `isDisabled` boolean
    - `subPurpose` object[]
      - `purposeId` string
      - `title` string
      - `slug` string
      - `isDisabled` boolean
      - `description` object
        - `Instructions for Remittance` string[]
    - `description` string

## Other responses

- `500` — 500

---

[API](https://skmtc.net/stockal/apis/uat-client-api-v2.md) · [All operations](https://skmtc.net/stockal/apis/uat-client-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockal/uat-client-api-v2/versions/08e36bbbd3be/schema)