cURL
curl --request GET \
--url https://commet.co/api/v1/offers \
--header 'x-api-key: <api-key>'import { Commet } from "@commet/node";
const commet = new Commet({ apiKey: "ck_xxx" });
const response = await commet.offers.list();from commet import Commet
commet = Commet("ck_xxx")
offers_list_result = commet.offers.list()client, err := commet.New("ck_xxx")
if err != nil {
log.Fatal(err)
}
ctx := context.Background()
offersListResult, err := client.Offers.List(ctx, nil)
if err != nil {
log.Fatal(err)
}import co.commet.Commet;
import co.commet.params.ListOffersParams;
var commet = Commet.builder().apiKey("ck_xxx").build();
var offersListResult = commet.offers().list(ListOffersParams.builder().build());use Commet\Commet;
$commet = new Commet('ck_xxx');
$offersListResult = $commet->offers->list();{
"object": "list",
"data": [
{
"id": "offer_1a2b3c4d",
"name": "Launch discount",
"phases": [
{
"type": "percentage",
"durationCycles": 3,
"durationInterval": "monthly",
"percentage": 20
}
],
"metadata": {},
"startsAt": null,
"endsAt": null,
"active": true,
"createdAt": "2026-09-07T12:00:00.000Z",
"updatedAt": "2026-09-07T12:00:00.000Z",
"object": "offer",
"livemode": false
}
],
"hasMore": false
}{
"error": {
"type": "validation_error",
"code": "validation_error",
"message": "The request contains an invalid parameter.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/validation_error.md"
}
}{
"error": {
"type": "authentication_error",
"code": "unauthorized",
"message": "A valid API key is required.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/unauthorized.md"
}
}{
"error": {
"type": "authentication_error",
"code": "forbidden",
"message": "You do not have permission to perform this operation.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/forbidden.md"
}
}{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Too many requests. Retry after the interval specified in the Retry-After header.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/rate_limited.md"
}
}{
"error": {
"type": "internal_error",
"code": "internal_error",
"message": "An unexpected error occurred while processing the request.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/internal_error.md"
}
}Offers
List offers
List reusable offer terms. Offers are independent from plans, prices, eligibility, and distribution channels.
GET
/
offers
cURL
curl --request GET \
--url https://commet.co/api/v1/offers \
--header 'x-api-key: <api-key>'import { Commet } from "@commet/node";
const commet = new Commet({ apiKey: "ck_xxx" });
const response = await commet.offers.list();from commet import Commet
commet = Commet("ck_xxx")
offers_list_result = commet.offers.list()client, err := commet.New("ck_xxx")
if err != nil {
log.Fatal(err)
}
ctx := context.Background()
offersListResult, err := client.Offers.List(ctx, nil)
if err != nil {
log.Fatal(err)
}import co.commet.Commet;
import co.commet.params.ListOffersParams;
var commet = Commet.builder().apiKey("ck_xxx").build();
var offersListResult = commet.offers().list(ListOffersParams.builder().build());use Commet\Commet;
$commet = new Commet('ck_xxx');
$offersListResult = $commet->offers->list();{
"object": "list",
"data": [
{
"id": "offer_1a2b3c4d",
"name": "Launch discount",
"phases": [
{
"type": "percentage",
"durationCycles": 3,
"durationInterval": "monthly",
"percentage": 20
}
],
"metadata": {},
"startsAt": null,
"endsAt": null,
"active": true,
"createdAt": "2026-09-07T12:00:00.000Z",
"updatedAt": "2026-09-07T12:00:00.000Z",
"object": "offer",
"livemode": false
}
],
"hasMore": false
}{
"error": {
"type": "validation_error",
"code": "validation_error",
"message": "The request contains an invalid parameter.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/validation_error.md"
}
}{
"error": {
"type": "authentication_error",
"code": "unauthorized",
"message": "A valid API key is required.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/unauthorized.md"
}
}{
"error": {
"type": "authentication_error",
"code": "forbidden",
"message": "You do not have permission to perform this operation.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/forbidden.md"
}
}{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Too many requests. Retry after the interval specified in the Retry-After header.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/rate_limited.md"
}
}{
"error": {
"type": "internal_error",
"code": "internal_error",
"message": "An unexpected error occurred while processing the request.",
"doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/internal_error.md"
}
}List reusable offer terms. Offers are independent from plans, prices, eligibility, and distribution channels.
Autorizaciones
Encabezados
API version used by this reference. Send this header to select this contract explicitly.
Parámetros de consulta
Minimum string length:
1Rango requerido:
1 <= x <= 100¿Esta página le ayudó?