---
title: "Get giveaway links"
method: GET
path: "/open-api/v1.0/giveaway-links/packages/{packageId}"
tags: ["Giveaway links"]
---

# Get giveaway links

`GET /open-api/v1.0/giveaway-links/packages/{packageId}`

## Request

- Base URL: `https://api.fourthwall.com`
- URL: `https://api.fourthwall.com/open-api/v1.0/giveaway-links/packages/{packageId}`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth`
    - Scopes: `giveaway_read`
  - HTTP basic

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Returns all giveaway links for packageId

## Path parameters

- `packageId` string, required

## Response `200`

OK

- ComFourthwallOpenapiModelGiveawayLinksV1
  - `packageId` string, required
  - `giveawayLinks` union[], required
    - union
      - ComFourthwallOpenapiModelGiveawayLinksV1GiveawayLinkV1Available
        - `status` 'AVAILABLE', required
        - `id` string, required
        - `link` string, required
        - `productId` string, required
        - `createdAt` string, date-time, required
      - ComFourthwallOpenapiModelGiveawayLinksV1GiveawayLinkV1Cancelled
        - `status` 'CANCELLED', required
        - `id` string, required
        - `link` string, required
        - `productId` string, required
        - `createdAt` string, date-time, required
        - `cancelledAt` string, date-time, required
      - ComFourthwallOpenapiModelGiveawayLinksV1GiveawayLinkV1Redeemed
        - `status` 'REDEEMED', required
        - `id` string, required
        - `link` string, required
        - `productId` string, required
        - `createdAt` string, date-time, required
        - `redeemedAt` string, date-time, required

## Other responses

- `404`: Possible errors: `SHOP_TEAM_MEMBER_SHOP_NOT_FOUND_ERROR`
- `429`: Rate limited: 100 requests / 10 seconds per shop.

## Changes

- **2026-07-21** `d02dd5a76313`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/changes/open-api/v1.0/giveaway-links/packages/:packageId/get.md)

---

[API](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2.md) - [All operations](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/revisions/77de1061d5c9?raw)