---
updatedAt: 2026-02-06T00:24:43.000Z
agentTools:
  projectIndex: https://developer.greendot.com/embedded-finance/llms.txt
---

# Get Card Replacement Options

Retrieves all available card replacement options for the specified account and program. Use this endpoint to determine which card types or options can be issued as replacements for a given account.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "BaaS APIs",
    "description": "Green Dot BaaS Partner API",
    "version": "v1",
    "x-generated-timestamp-utc": "2026-02-05T01:14:54.4774970Z"
  },
  "paths": {
    "/programs/{programCode}/accounts/{accountIdentifier}/cardOptions": {
      "get": {
        "tags": [
          "CardOption"
        ],
        "summary": "Get Card Replacement Options",
        "description": "Retrieves all available card replacement options for the specified account and program. Use this endpoint to determine which card types or options can be issued as replacements for a given account.",
        "operationId": "CardOption_GET_GetReplacementCards",
        "parameters": [
          {
            "name": "X-GD-RequestId",
            "in": "header",
            "description": "The unique request identifier for idempotency and tracking. Must be provided in the X-GD-RequestId header.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "programCode",
            "in": "path",
            "description": "The program code associated with the partner implementation.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "accountIdentifier",
            "in": "path",
            "description": "The unique identifier of the account for which to retrieve card options. Must be a valid GUID.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetReplacementCardResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CardOption": {
        "type": "object",
        "properties": {
          "cardType": {
            "type": "string",
            "description": "The type of card available for replacement (e.g., \"debit\", \"credit\", \"virtual\").",
            "nullable": true
          },
          "fee": {
            "type": "number",
            "description": "The fee amount (in USD) associated with selecting this card option for replacement.",
            "format": "double"
          },
          "isFreeEligible": {
            "type": "boolean",
            "description": "Indicates whether the card option is eligible for a free replacement."
          }
        },
        "additionalProperties": false,
        "description": "Card Option – Represents a card type or option available for replacement.\r\nUsed to provide details about a specific card option, including card type, associated fee, and eligibility for free replacement."
      },
      "GetReplacementCardResponse": {
        "type": "object",
        "properties": {
          "options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CardOption"
            },
            "description": "The list of available card options for the account.\r\nEach item contains details about a card option that can be issued as a replacement.",
            "nullable": true
          },
          "responseDetails": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDetail"
            },
            "description": "Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Get Replacement Card Response – Contains the list of available card options for a specific account.\r\nUsed to provide card option details such as type, description, and eligibility."
      },
      "ResponseDetail": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "The primary status or error code for the response (e.g., 200 for success, 400 for validation error).",
            "format": "int32"
          },
          "subCode": {
            "type": "integer",
            "description": "An optional subcode providing more granular detail about the response or error.",
            "format": "int32",
            "nullable": true
          },
          "description": {
            "type": "string",
            "description": "A human-readable description of the response, error, or status.",
            "nullable": true
          },
          "url": {
            "type": "string",
            "description": "A URL linking to documentation or a web page with more information about the response code.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Represents a detailed status or error message for an API response.\r\nContains a code, optional subcode, human-readable description, and a URL for more information.\r\nUsed to provide granular feedback about the outcome of an operation, including success, warnings, or errors."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "description": "bearer token",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "samples-languages": [
      "csharp",
      "java",
      "python",
      "node",
      "objectivec"
    ]
  }
}
```