> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Unfreeze Card

> Restore a frozen card to active status. POST /cards/{id}/unfreeze. Requires cards:write scope.

## Overview

Restores a frozen card to `ACTIVE` status. Transactions are accepted again immediately. The card balance is unchanged.

## Path Parameters

| Parameter | Type   | Description                 |
| --------- | ------ | --------------------------- |
| `id`      | string | The card ID (prefix `crd_`) |

## Request Body

This endpoint has no request body.

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/unfreeze \
    -H "Authorization: Bearer $FYATU_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const resp = await fetch(
    'https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/unfreeze',
    {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${process.env.FYATU_API_KEY}` }
    }
  );
  const body = await resp.json();
  console.log(body.data.status); // "ACTIVE"
  ```

  ```python Python theme={null}
  import os, requests

  resp = requests.post(
      'https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/unfreeze',
      headers={'Authorization': f'Bearer {os.environ["FYATU_API_KEY"]}'}
  )
  card = resp.json()['data']
  print(card['status'])  # ACTIVE
  ```
</CodeGroup>

## Success Response (200)

Returns the updated card with `status: ACTIVE` and `frozenAt: null`:

```json theme={null}
{
  "success": true,
  "status": 200,
  "message": "Card unfrozen",
  "data": {
    "id":             "crd_01HXYZ5555ABCDEF1111",
    "cardholderId":   "chl_01HXYZ1234ABCDEF5678",
    "productId":      "prd_01HXYZ7777ABCDEF3333",
    "status":         "ACTIVE",
    "cardType":       "VIRTUAL",
    "cardBrand":      "VISA",
    "maskedPan":      "**** **** **** 4242",
    "last4":          "4242",
    "expirationDate": "05/2029",
    "currency":       "USD",
    "createdAt":      "2026-05-22T09:00:00Z",
    "updatedAt":      "2026-05-26T10:15:00Z"
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-26T10:15:00Z"
  }
}
```

## Webhook

A `CARD_UNFROZEN` event fires after a successful unfreeze:

```json theme={null}
{
  "event":      "CARD_UNFROZEN",
  "eventId":    "evt_01HXY123456ABCDEF",
  "businessId": "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":  "2026-05-26T10:15:00Z",
  "data": {
    "cardId":       "crd_01HXYZ5555ABCDEF1111",
    "status":       "ACTIVE",
    "cardType":     "VIRTUAL",
    "cardholderId": "chl_01HXYZ1234ABCDEF5678"
  }
}
```

## Error Codes

| Code                      | HTTP | Cause                                                          |
| ------------------------- | ---- | -------------------------------------------------------------- |
| `CARD_NOT_FOUND`          | 404  | Card does not exist or belongs to another business/environment |
| `CARD_NOT_FROZEN`         | 409  | Card is not currently frozen                                   |
| `CARD_ALREADY_TERMINATED` | 422  | Cannot unfreeze a terminated card                              |
| `INSUFFICIENT_SCOPE`      | 403  | Key lacks `cards:write` scope                                  |


## OpenAPI

````yaml v3.20/openapi.json POST /cards/{id}/unfreeze
openapi: 3.1.0
info:
  title: FYATU CaaS API v3.20
  description: >-
    FYATU Cards-as-a-Service API — API key authentication, Cardholder
    lifecycle, Card issuance, Transactions, Webhooks, and Programs.
  version: 3.20.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3.20
    description: >-
      FYATU CaaS API — the environment (LIVE or SANDBOX) is determined by the
      API key, not the URL
security:
  - BearerAuth: []
tags:
  - name: Meta
    description: Liveness, account info, and supported event types
  - name: Account
    description: Account-level balance and funding status
  - name: Programs
    description: Read card program configuration
  - name: Cardholders
    description: Create and manage cardholder profiles
  - name: Cards
    description: Issue, fund, freeze, and terminate virtual cards
  - name: Transactions
    description: Read-only card transaction history
  - name: Webhooks
    description: Manage webhook endpoints for real-time event delivery
  - name: Products
    description: Read card product configurations
paths:
  /cards/{id}/unfreeze:
    post:
      tags:
        - Cards
      summary: Unfreeze a card
      description: Restore transaction access to a frozen card.
      operationId: unfreezeCard
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          example: crd_01HXYZ5555ABCDEF1111
      responses:
        '200':
          description: Card unfrozen
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardResponse'
              example:
                success: true
                status: 200
                message: Card unfrozen
                data:
                  id: crd_01HXYZ5555ABCDEF1111
                  cardholderId: chl_01HXYZ1234ABCDEF5678
                  productId: prd_01HXYZ7777ABCDEF3333
                  status: ACTIVE
                  cardType: VIRTUAL
                  cardBrand: VISA
                  maskedPan: '**** **** **** 4242'
                  last4: '4242'
                  expirationDate: 05/2029
                  currency: USD
                  createdAt: '2026-05-22T09:00:00Z'
                  updatedAt: '2026-05-26T10:15:00Z'
                meta:
                  requestId: req_a1b2c3d4e5f6a7b8c9d0e1f2
                  platform: Fyatu CaaS
                  timestamp: '2026-05-26T10:15:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          description: Card is not frozen
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                success: false
                status: 409
                message: Card is not frozen
                error:
                  code: CARD_NOT_FROZEN
                  detail: Card is not frozen
                meta:
                  requestId: req_a1b2c3d4e5f6a7b8c9d0e1f2
                  platform: Fyatu CaaS
                  timestamp: '2026-05-22T15:00:00Z'
        '429':
          $ref: '#/components/responses/RateLimitExceeded'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    CardResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        status:
          type: integer
          example: 200
        message:
          type: string
          example: Card retrieved
        data:
          $ref: '#/components/schemas/CardDetail'
        meta:
          $ref: '#/components/schemas/Meta'
      example:
        success: true
        status: 200
        message: Card retrieved
        data:
          id: crd_01HXYZ5555ABCDEF1111
          cardholderId: chl_01HXYZ1234ABCDEF5678
          productId: prd_01HXYZ1111ABCDEF0001
          status: ACTIVE
          cardType: VIRTUAL
          cardBrand: VISA
          maskedPan: 445123******4123
          last4: '4123'
          expirationDate: 06/2030
          balance: 100
          heldAmount: 53.88
          pendingAuthorizations:
            - merchantName: LOTUS'S 5121 CHALONG
              mcc: '5411'
              amount: 43.3
              currency: USD
              authorizedAt: '2026-07-08 14:32:10'
            - merchantName: NIRANAPA BOUTIQUE RESO
              mcc: '7011'
              amount: 9.52
              currency: USD
              authorizedAt: '2026-07-08 09:15:44'
          needsReissue: false
          currency: USD
          cvv: '123'
          features:
            has3DS: true
            hasApplePay: false
            hasGooglePay: false
            hasJIT: false
            hasSpendControl: true
            hasMccControl: false
            isReloadable: true
            isOneTimeUse: false
          spendingLimit: 1000
          spendingPeriod: DAILY
          billingAddress:
            address: 1234 Main St
            city: New York
            state: NY
            zipCode: '10001'
            country: US
          createdAt: '2026-05-26T10:00:00Z'
          updatedAt: '2026-05-26T10:00:00Z'
        meta:
          requestId: req_01HXY123456ABCDEF
          platform: Fyatu CaaS
          timestamp: '2026-05-26T10:00:00Z'
    Error:
      type: object
      properties:
        success:
          type: boolean
          example: false
        status:
          type: integer
          example: 422
        message:
          type: string
          example: Human readable message
        error:
          $ref: '#/components/schemas/ErrorBody'
        meta:
          $ref: '#/components/schemas/Meta'
    CardDetail:
      type: object
      description: >-
        Full card object returned by GET /cards/{id}. Includes live balance,
        full PAN, CVV, features, and billing address.
      properties:
        id:
          type: string
          example: crd_01HXYZ5555ABCDEF1111
        cardholderId:
          type: string
          example: chl_01HXYZ1234ABCDEF5678
        productId:
          type: string
          nullable: true
          example: prd_01HXYZ1111ABCDEF0001
        status:
          type: string
          enum:
            - CREATING
            - ACTIVE
            - FROZEN
            - TERMINATED
          example: ACTIVE
        cardType:
          type: string
          enum:
            - VIRTUAL
            - PHYSICAL
          example: VIRTUAL
        cardBrand:
          type: string
          enum:
            - VISA
            - MASTERCARD
          example: VISA
        maskedPan:
          type: string
          nullable: true
          description: Populated after provisioning completes
          example: 445123******4123
        last4:
          type: string
          nullable: true
          description: Populated after provisioning completes
          example: '4123'
        pan:
          type: string
          nullable: true
          description: >-
            Full unmasked card number — only present when the card is
            provisioned at the provider
          example: '4451230000004123'
        expirationDate:
          type: string
          nullable: true
          description: Card expiry in MM/YYYY format
          example: 06/2030
        balance:
          type: number
          format: float
          nullable: true
          description: >-
            Available (spendable) card balance in USD fetched from the card
            provider, net of any pending authorization holds
          example: 100
        heldAmount:
          type: number
          format: float
          nullable: true
          description: >-
            Total value of pending authorization holds (liens) currently placed
            on the card. Funds are reserved but not yet settled. Available
            balance already excludes this amount.
          example: 53.88
        pendingAuthorizations:
          type: array
          nullable: true
          description: >-
            Individual pending authorization holds making up heldAmount. Each
            entry is a merchant authorization awaiting settlement or reversal.
          items:
            type: object
            properties:
              merchantName:
                type: string
                nullable: true
                description: Merchant that placed the hold
                example: LOTUS'S 5121 CHALONG
              mcc:
                type: string
                nullable: true
                description: Merchant category code
                example: '5411'
              amount:
                type: number
                format: float
                description: Held amount in USD
                example: 43.3
              currency:
                type: string
                description: Currency of the hold
                example: USD
              authorizedAt:
                type: string
                description: When the authorization was placed (UTC, YYYY-MM-DD HH:MM:SS)
                example: '2026-07-08 14:32:10'
        needsReissue:
          type: boolean
          nullable: true
          description: >-
            True when the provider flags the card for reissue (e.g. expired or
            compromised) and a replacement should be requested
          example: false
        currency:
          type: string
          example: USD
        cvv:
          type: string
          nullable: true
          description: Card verification value
          example: '123'
        features:
          type: object
          nullable: true
          properties:
            has3DS:
              type: boolean
              example: true
            hasApplePay:
              type: boolean
              example: false
            hasGooglePay:
              type: boolean
              example: false
            hasJIT:
              type: boolean
              example: false
            hasSpendControl:
              type: boolean
              example: true
            hasMccControl:
              type: boolean
              example: false
            isReloadable:
              type: boolean
              example: true
            isOneTimeUse:
              type: boolean
              example: false
        spendingLimit:
          type: number
          format: float
          nullable: true
          example: 1000
        spendingPeriod:
          type: string
          nullable: true
          example: DAILY
        billingAddress:
          type: object
          nullable: true
          properties:
            address:
              type: string
              example: 1234 Main St
            city:
              type: string
              example: New York
            state:
              type: string
              example: NY
            zipCode:
              type: string
              example: '10001'
            country:
              type: string
              example: US
        createdAt:
          type: string
          format: date-time
          example: '2026-05-26T10:00:00Z'
        updatedAt:
          type: string
          format: date-time
          example: '2026-05-26T10:00:00Z'
        frozenAt:
          type: string
          format: date-time
          nullable: true
          description: Present when status is FROZEN
          example: null
        terminatedAt:
          type: string
          format: date-time
          nullable: true
          description: Present when status is TERMINATED
          example: null
    Meta:
      type: object
      properties:
        requestId:
          type: string
          example: req_a1b2c3d4e5f6a7b8c9d0e1f2
        platform:
          type: string
          example: Fyatu CaaS
        timestamp:
          type: string
          format: date-time
          example: '2026-05-22T15:00:00Z'
    ErrorBody:
      type: object
      properties:
        code:
          type: string
          example: VALIDATION_ERROR
        detail:
          type: string
          example: dateOfBirth must be in YYYY-MM-DD format
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missing:
              summary: API key missing
              value:
                success: false
                status: 401
                message: API key is required
                error:
                  code: AUTH_TOKEN_MISSING
                  detail: API key is required
                meta:
                  requestId: req_a1b2c3d4e5f6a7b8c9d0e1f2
                  platform: Fyatu CaaS
                  timestamp: '2026-05-22T15:00:00Z'
            invalid:
              summary: API key invalid
              value:
                success: false
                status: 401
                message: Invalid API key
                error:
                  code: AUTH_TOKEN_INVALID
                  detail: Invalid API key
                meta:
                  requestId: req_a1b2c3d4e5f6a7b8c9d0e1f2
                  platform: Fyatu CaaS
                  timestamp: '2026-05-22T15:00:00Z'
    Forbidden:
      description: Scope denied or business suspended
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            success: false
            status: 403
            message: Scope denied
            error:
              code: INSUFFICIENT_SCOPE
              detail: This endpoint requires the cards:write scope
            meta:
              requestId: req_a1b2c3d4e5f6a7b8c9d0e1f2
              platform: Fyatu CaaS
              timestamp: '2026-05-22T15:00:00Z'
    NotFound:
      description: Resource not found or does not belong to your business
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimitExceeded:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            success: false
            status: 429
            message: Rate limit exceeded
            error:
              code: RATE_LIMIT_EXCEEDED
              detail: Too many requests
            meta:
              requestId: req_a1b2c3d4e5f6a7b8c9d0e1f2
              platform: Fyatu CaaS
              timestamp: '2026-05-22T15:00:00Z'
    InternalError:
      description: Unexpected server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            success: false
            status: 500
            message: Internal error
            error:
              code: INTERNAL_ERROR
              detail: An unexpected error occurred
            meta:
              requestId: req_a1b2c3d4e5f6a7b8c9d0e1f2
              platform: Fyatu CaaS
              timestamp: '2026-05-22T15:00:00Z'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key from the FYATU CaaS portal. Pass as `Authorization: Bearer
        <key>`.

````