---
title: "Get group recurring expenses"
method: GET
path: "/recurring-expenses/groups/{groupId}"
tags: ["recurring expenses"]
---

# Get group recurring expenses

`GET /recurring-expenses/groups/{groupId}`

## Request

- Base URL: `http://localhost:3001`
- URL: `http://localhost:3001/recurring-expenses/groups/{groupId}`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

Get all recurring expenses for a specific group

## Path parameters

- `groupId` string, required

## Query parameters

- `page` number
- `limit` number

## Response `200`

Group recurring expenses retrieved successfully

- object
  - `data` PaginatedRecurringExpensesResponseDto
    - `data` RecurringExpenseResponseDto[], required
      - `id` string, required
      - `groupId` string, required
      - `description` string, required
      - `totalAmount` number, required
      - `currency` string, required
      - `createdBy` string, required
      - `frequency` 'daily' | 'weekly' | 'monthly' | 'yearly', required
      - `startDate` string, date-time, required
      - `endDate` string, date-time
      - `nextExecutionDate` string, date-time, required
      - `isActive` boolean, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `payers` RecurringExpensePayerResponseDto[], required
        - `id` string, required
        - `userId` string, required
        - `amount` number, required
        - `user` UserInfoDto, required
          - `id` string, required
          - `displayName` string, required
          - `email` string, required
      - `recipients` RecurringExpenseRecipientResponseDto[], required
        - `id` string, required
        - `userId` string, required
        - `amount` number, required
        - `user` UserInfoDto, required
          - `id` string, required
          - `displayName` string, required
          - `email` string, required
      - `group` GroupInfoDto
        - `id` string, required
        - `name` string, required
    - `total` number, required
    - `page` number, required
    - `limit` number, required
    - `hasNext` boolean, required
    - `hasPrev` boolean, required
  - `success` boolean
  - `message` string

## Other responses

- `400`: Bad Request - Invalid input or validation failed
- `401`: Unauthorized - Authentication required or invalid token
- `403`: Forbidden - Insufficient permissions to access this resource
- `404`: Not Found - The requested resource does not exist
- `500`: Internal Server Error - An unexpected error occurred

---

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