---
title: "Redeem a promo code"
method: POST
path: "/tenants/{tenant_id}/billing/promo_codes"
tags: ["Billing"]
---

# Redeem a promo code

`POST /tenants/{tenant_id}/billing/promo_codes`

## Request

- Base URL: `https://api.laserdata.cloud`
- URL: `https://api.laserdata.cloud/tenants/{tenant_id}/billing/promo_codes`
- Auth: one of:
  - API key in header `ld-api-key`
  - API key in cookie `session`

Redeems a promo code once per tenant and returns the granted credit. Credits reduce upcoming invoices until the balance or the code expiry is reached.

## Path parameters

- `tenant_id` integer, required

## Request body

- RedeemPromoCode
  - `code` string, required

## Response `201`

Credit granted

- TenantCreditInfo: Credit balance a tenant redeemed. Invoices consume `remaining` oldest first.
  - `amount` string, required
  - `created_at` string, date-time, required
  - `currency` 'USD', required
  - `expires_at` string, date-time, nullable
  - `id` integer, required
  - `promo_code_id` integer, required
  - `remaining` string, required
  - `tenant_id` integer, required

## Other responses

- `400`: Promo code is invalid or not applicable
- `409`: Promo code already redeemed by this tenant
- `429`: Promo-code attempt rate limit exceeded

## Changes

- **2026-09-09** `70c34a1d3248`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/laserdata/apis/laserdata-cloud-core-api/changes/tenants/:tenant_id/billing/promo_codes/post.md)

---

[API](https://skmtc.dev/laserdata/apis/laserdata-cloud-core-api.md) - [All operations](https://skmtc.dev/laserdata/apis/laserdata-cloud-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/laserdata/apis/laserdata-cloud-core-api/revisions/96e0917c06de?raw)