---
title: "Redeem airtime."
method: POST
path: "/v0.2.4/redeem/airtime"
tags: ["Redeem"]
---

# Redeem airtime.

`POST /v0.2.4/redeem/airtime`

## Request body

- object
  - `subAccount` string — Subaccount if any.
  - `chiRef` string, required — Chi reference.
  - `phoneNumber` string, required — Phone number.
  - `countryToSend` string, required — Country to send to.
  - `meta` object — Any data to be sent along with request.
    - `test` boolean

## Response `200`

Success.

- object
  - `status` string
  - `message` string
  - `data` object
    - `payoutLink` string
    - `data` object
      - `id` string
      - `valueInUSD` number
      - `chimoney` number
      - `issueID` string
      - `fee` number
      - `type` string
      - `subAccount` string
      - `issuer` string
      - `t_id` number
      - `chiRef` string
      - `meta` object
      - `integration` object
        - `appID` string
        - `isFromScrim` boolean
      - `turnOffNotification` boolean
      - `issueDate` string
      - `payerEmail` string
      - `redirect_url` string
      - `redeemData` object
        - `walletID` string
      - `initiatedBy` string
      - `fundsAvailableDate` string, nullable
      - `updatedDate` string
      - `paymentDate` string
      - `status` string
    - `error` string
    - `payouts` object[]
      - `amount` string
      - `discount` string
      - `errorMessage` string
      - `phoneNumber` string
      - `requestId` string
      - `status` string

## Other responses

- `400` — Validation error in the request.
- `401` — Access to this resource is not available for unauthenticated users.
- `403` — Access to this resource is forbidden.
- `404` — Error indicating that the transaction was not found.
- `500` — Indicates an internal server error.

---

[API](https://skmtc.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/revisions/227751df36a0/schema)