---
title: "List all Recurring Payins"
method: GET
path: "/recurring-payin"
tags: ["Recurring Payin"]
---

# List all Recurring Payins

`GET /recurring-payin`

## Request

- Base URL: `https://api.finmo.net/v1`
- URL: `https://api.finmo.net/v1/recurring-payin`
- Auth: HTTP basic

Retrieve a list of all the Recurring Payins. You can filter the list with query parameters.

This API comes with Pagination support, you can customize ```limit``` and ```page``` query parameters as per the requirements.

## Query parameters

- `limit` integer
- `page` integer
- `start_time` integer
- `end_time` integer
- `recurring_payin_id` string
- `payment_plan_id` string
- `customer_id` string
- `amount` number
- `frequency` string
- `status` string

## Response `200`

OK

- object
  - `data` object[]
    - `recurring_payin_id` string
    - `payment_plan_id` string, nullable
    - `customer_id` string, nullable
    - `recurring_payin_token` string, nullable
    - `redirect_url` string, uri, nullable
    - `initial_activation_delay` integer, nullable
    - `initial_activation_delay_text` string, nullable
    - `is_auto_debit` boolean
    - `is_amount_fixed` boolean
    - `is_triggered_manually` boolean
    - `country` string
    - `currency` string
    - `amount` number, nullable
    - `status` 'CREATED' | 'ACTIVE' | 'CANCELLED' | 'COMPLETED'
    - `frequency` 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY'
    - `start_at` string, date-time
    - `end_at` string, date-time, nullable
    - `created_at` string, date-time
    - `next_installment_at` string, date-time, nullable
    - `additional_data` object, nullable
    - `is_active` boolean

## Changes

- **2026-11-03** `39e5e5ab5c3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/finmo/apis/finmo-api/changes/recurring-payin/get.md)

---

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