---
title: "GET /experimental/orgs/{orgId}/promotions"
method: GET
path: "/experimental/orgs/{orgId}/promotions"
tags: ["Orgs"]
---

# GET /experimental/orgs/{orgId}/promotions

`GET /experimental/orgs/{orgId}/promotions`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/orgs/{orgId}/promotions`
- Auth: none declared

Lists the promotion offers the signed-in user may activate for this org, each with its state. Offers the user is not eligible for are left out. Returns 403 for a user who is not a member of the org, and for an API key.

## Path parameters

- `orgId` string, uuid, required

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
    - `next` string, uri, nullable, required
    - `prev` string, uri, nullable, required
  - `meta` object, required
    - `count` number, required
  - `data` object[], required
    - `id` string, required: The campaign id.
    - `type` 'promotion-offer', required
    - `attributes` object, required
      - `state` union, required: `available`: the user may activate the offer for this org. `activated`: the org already has it, activated by this user or a colleague.
        - 'available'
        - 'activated'
      - `credits` integer, required: Credits the offer grants.

## Other responses

- `401`: Unauthorized
- `403`: Default Response
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-29** `06d2142ed144`: 1 info
  - api operation id `listOrgPromotions` was added
- **2026-10-26** `300404337cdc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/promotions/get.md)

---

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