---
title: "Redeem Code"
method: POST
path: "/royalty/coins-redeem-codes"
---

# Redeem Code

`POST /royalty/coins-redeem-codes`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/royalty/coins-redeem-codes`
- Auth: none declared

## Request body

- object
  - `description` string, required: Descripción del código
  - `code` string: El código para redimir
  - `amount` number, required: Monto del código
  - `expirationDate` string, date-time: Fecha de expiración del código

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` RoyaltyCoinsRedeemCode
    - `_id` string: El ID del código
    - `websiteId` string: El ID de la marca
    - `code` string: El código para redimir
    - `description` string: Descripción del código
    - `source` 'api' | 'admin' | 'giftCard': Origen del código
    - `amount` number: Monto del código
    - `expirationDate` string, date-time: Fecha de expiración del código
    - `isRedeemed` boolean: Indica si el código ha sido redimido
    - `redeemedAt` string, date-time: Fecha de redención del código
    - `redeemedById` string: ID del usuario que redimió el código
    - `redeemedByEmail` string: Email del usuario que redimió el código
    - `createdAt` string, date-time: Fecha de creación del código
    - `createdById` string: ID del usuario que creó el código
    - `deletedAt` string, date-time: Fecha de eliminación del código, si es que esta eliminado

## Other responses

- `400`: Errors

## Changes

- **2025-08-18** `bf1ae81aa046`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/royalty/coins-redeem-codes/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)