GET/cards/{cardId}/fees

Get 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 {}.

bash
curl -X GET "{{baseUrl}}/cards/{{cardId}}/fees" \
  -H "session-token: {{sessionToken}}" \
  -H "Accept: application/json"

Path variables

FieldTypeRequiredPossible valuesDescription
cardIdstringRequired55d0c52f-79ee-4d38-acf4-a16c07957898

Card reference ID from list cards.

Headers

FieldTypeRequiredPossible valuesDescription
session-tokenstringRequired

SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header.

Additional info

FieldTypeRequiredPossible valuesDescription
200 — Empty fee configobjectOptional

No configured fees for this card.

404 — Card not foundobjectOptional

cardId does not resolve to a card owned by this broker.

Example200 — Empty fee config

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": {}
}

Example404 — 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

FieldTypePossible valuesDescription
ResponseCodeinteger200 | 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).

ResponseMessagestringSuccess | 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.

ResponseDataobjectPlease 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.CardIssueFeestring

Debit card issue fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`.

ResponseData.AnnualFeestring

Yearly usage fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`.

ResponseData.ReplacementFeestring

Reissuance fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`.

ResponseData.AtmFeestring

ATM fee within USA (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`.

ResponseData.InternationalFeestring

ATM fee outside USA (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`.

ResponseData.FxMarkupstring

FX / outside-USA transaction fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`.

ResponseData.BalanceInquiryFeestring

Balance inquiry fee (if configured / positive). Currency string, e.g. `"$25.00"`. Currency string, e.g. `"$25.00"`.

ResponseData.PriorityShippingFeestring

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.

Search guide books, endpoints, paths, or parameters

↑↓navigateopenEscclose