/cards/{cardId}/feesGet Card Fees
Returns configured fees for a card. Fee values are currency strings with a leading $ and 2 decimal places (e.g. "$25.00"), not bare numbers.
Only configured/positive fees are returned, except PriorityShippingFee, which may show "$0.00". Empty config returns {}.
curl -X GET "{{baseUrl}}/cards/{{cardId}}/fees" \
-H "session-token: {{sessionToken}}" \
-H "Accept: application/json"Path variables
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
cardId | string | Required | 55d0c52f-79ee-4d38-acf4-a16c07957898 | Card reference ID from list cards. |
Headers
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
session-token | string | Required | — | SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header. |
Additional info
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
200 — Empty fee config | object | Optional | — | No configured fees for this card. |
404 — Card not found | object | Optional | — | cardId does not resolve to a card owned by this broker. |
Example— 200 — Empty fee config
{
"ResponseCode": 200,
"ResponseMessage": "Success",
"ResponseData": {}
}Example— 404 — Card not found
{
"ResponseCode": 404,
"ResponseMessage": "Card not found",
"ResponseData": null
}Path param stays camelCase (`cardId`). Response fee keys are PascalCase. Fee amounts are `$`-prefixed strings with 2 decimal places.
Response
| Field | Type | Possible values | Description |
|---|---|---|---|
ResponseCode | integer | 200 | 201 | 204 | 301 | 400 | 401 | 403 | 404 | 410 | 422 | 500 | 503 | API result code in the response envelope. Indicates success or the error category (e.g. 200 success, 400 bad request, 401 unauthorized). |
ResponseMessage | string | Success | Created | NoContent | BadRequest | Unauthorized | Forbidden | NotFound | Gone | UnprocessableContent | ServerError | ResourceMoved | ServiceUnAvailable | UnProcessableEntity | Human-readable label paired with ResponseCode (e.g. Success, BadRequest, Unauthorized). Use with ResponseCode to interpret the outcome. |
ResponseData | object | Please refer to below example for response body | Configured fee map. Values are strings like `"$25.00"`. Keys appear only when configured (except PriorityShippingFee, which may be `"$0.00"`). Empty config: `{}`. |
ResponseData.CardIssueFee | string | — | Debit card issue fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`. |
ResponseData.AnnualFee | string | — | Yearly usage fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`. |
ResponseData.ReplacementFee | string | — | Reissuance fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`. |
ResponseData.AtmFee | string | — | ATM fee within USA (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`. |
ResponseData.InternationalFee | string | — | ATM fee outside USA (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`. |
ResponseData.FxMarkup | string | — | FX / outside-USA transaction fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`. |
ResponseData.BalanceInquiryFee | string | — | Balance inquiry fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`. |
ResponseData.PriorityShippingFee | string | — | Priority delivery fee (included even if `"$0.00"`). |
Example response
{
"ResponseCode": 200,
"ResponseMessage": "Success",
"ResponseData": {
"CardIssueFee": "$25.00",
"AnnualFee": "$10.00",
"ReplacementFee": "$15.00",
"AtmFee": "$2.50",
"InternationalFee": "$3.50",
"FxMarkup": "$1.50",
"BalanceInquiryFee": "$1.00",
"PriorityShippingFee": "$0.00"
}
}Requires `session-token: {SessionToken}` from Create GMA Session. Use the same client IP as authentication.