---
title: "Get contributions awaiting thank you"
method: GET
path: "/open-api/v1.0/thank-you-contributions"
tags: ["Thank yous"]
---

# Get contributions awaiting thank you

`GET /open-api/v1.0/thank-you-contributions`

## Request

- Base URL: `https://api.fourthwall.com`
- URL: `https://api.fourthwall.com/open-api/v1.0/thank-you-contributions`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth`
    - Scopes: `thankyou_read`
  - HTTP basic

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

Returns paginated list of orders, donations, and other contributions that can be thanked. The maximum page size is 100 - larger values are capped at 100.

## Query parameters

- `page` integer
- `size` integer
- `state` string[]
- `search` string
- `minValue` number, double
- `containsMsg` boolean

## Response `200`

OK

- ComFourthwallOpenapiModelOpenApiPageResponseComFourthwallOpenapiModelKudosOrderV1
  - `results` ComFourthwallOpenapiModelKudosOrderV1[], required
    - `id` string, required: Unique identifier for this kudos contribution
    - `orderId` string, required: The order/contribution ID
    - `supporter` ComFourthwallOpenapiModelKudosSupporterV1, required
      - `email` string, required
      - `fullName` string
    - `products` ComFourthwallOpenapiModelKudosProductV1[], required
      - `title` string, required
      - `thumbnailUrl` string
    - `message` string: Optional message from the supporter
    - `total` ComFourthwallOpenapiModelKudosMoneyV1, required
      - `amount` number, required
      - `currency` string, required
    - `state` 'WAITING' | 'SKIPPED' | 'SENT' | 'CANCELLED', required
    - `createdAt` string, date-time, required
  - `total` integer
  - `page` integer
  - `size` integer
  - `totalPages` integer

## Other responses

- `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/thank-you-contributions/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)