# List RFIs

Returns your business's RFIs across every entity type — payments, payins, payouts, refunds, orders and subscriptions — not just a single resource. Use `status` and `search` to filter the list, and the pagination parameters to page through results. Results are ordered by `created_at` descending.

Endpoint: GET /rfis
Version: 1.0.0
Security: JWT

## Query parameters:

  - `status` (string)
    Filter RFIs by status.

  - `search` (string)
    Filter by an exact match on either the RFI's `id` or the underlying entity's `id`.

  - `before` (string)
    [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp in UTC to filter resources created before this time. Use this to avoid `Page drift` issue. See [Pagination parameters](\./pagination#pagination-parameters) for more details.

  - `after` (string)
    [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp in UTC to filter resources created after this time. Use this to avoid `Page drift` issue. See [Pagination parameters](\./pagination#pagination-parameters) for more details.

  - `per_page` (integer)
    Number of resources per page. Should be between 1 and 100.

  - `page` (integer)
    Page number for pagination. Starts from 1. Get the next page number from the `next` field in the response.

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    The unique identifier for the RFI.
    Example: rfi_6a7c5018ZGuKP

  - `data.business_id` (string)
    The unique identifier of the business the RFI belongs to.
    Example: merch_685bb99eFhPGA

  - `data.entity_type` (string)
    The type of the underlying resource the RFI was raised against, for example `Payment`, `Payin`, `Payout`, `Refund`, `Order`, `Subscription` or `Chargeback`.
    Example: Payment

  - `data.entity_id` (string)
    The unique identifier of the underlying resource the RFI was raised against.
    Example: payt_6a7c50089mMiB

  - `data.status` (string)
    The current status of the RFI. `action_required` means documents are still owed — respond using [Respond to an RFI](/api-documentation/apis/openapi/rfi/respondrfi). `under_review` means documents have been submitted and are pending a decision. The final decision (`approved` or `rejected`) is communicated via webhook.
    Enum: "action_required", "under_review", "approved", "rejected", "superseded", "expired"

  - `data.created_at` (string)
    Timestamp representing when the RFI was created.
    Example: 2026-08-12T10:51:04.747Z

  - `data.updated_at` (string)
    Timestamp representing when the RFI was last updated.
    Example: 2026-08-13T06:42:00.878Z

  - `page_meta` (object)

  - `page_meta.current` (integer)
    The current page number.
    Example: 2

  - `page_meta.previous` (integer | null)
    The previous page number.
    Example: 1

  - `page_meta.next` (integer | null)
    The next page number.
    Example: 3

  - `page_meta.per_page` (integer)
    The number of items per page.
    Example: 20

  - `page_meta.pages` (integer)
    The total number of pages.
    Example: 10

  - `page_meta.count` (integer)
    The total number of items.
    Example: 200

## Response 400 fields (application/json):

  - `error` (string)
    Enum: "Bad Request"

  - `message` (string)
    Error message.
    Example: Validation failed: Status not_a_real_status is not a valid status