---
title: "Get card funding purpose"
method: GET
path: "/v3/funding-accounts/cards/funding-purposes"
tags: ["funding-accounts"]
---

# Get card funding purpose

`GET /v3/funding-accounts/cards/funding-purposes`

Get a list of card funding purpose values based on the vendor and card brand.

When you create a payment (`POST /v3/payments` or `POST /v3/payments/bulk`) with a `CARD_ACCOUNT` funding account `type`, BILL requires a vendor industry value for compliance. When BILL cannot identify the vendor industry, the `cardFundingPurpose` field must be set in your payment request.

Use this endpoint to get the list of card funding purpose values you can set. If you get an empty 200 response, BILL has information about the vendor industry and setting the `cardFundingPurpose` field is not required in your payment request.

## Query parameters

- `vendorId` string, required — BILL-generated ID of the vendor to be paid. The value begins with `009`.
- `brand` string, required — Card brand

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Response `200`

Get card funding purpose response

- ListCardFundingPurposesResponseDto — Card funding purposes dto.
  - `lastUsedPurpose` string — Last used purpose. This value was last used as the `cardFundingPurpose` value in a payment request. **Note**: This field is available only for the AMEX, VISA, and MASTERCARD card brands.
  - `results` FundingPurpose[] — List of card funding purpose values based on the vendor and card brand. Use a `subCategories` value for an AMEX, VISA, or MASTERCARD card brand. Use a `category` value for all other card brands.
    - `category` string — Purpose category
    - `subCategories` string[] — Purpose sub-category

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)