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 "{{API_BASE_URL}}/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": {}
}

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

Example— 404 — Card not found

{
  "ResponseCode": 404,
  "ResponseMessage": "Card not found",
  "ResponseData": null
}

{
  "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"
  }
}

{
  "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.