# List all orders

Returns a list of your orders. The orders are returned sorted by creation date, with the most recent order appearing first.

Endpoint: GET /orders
Version: 1.0.0
Security: JWT

## Query parameters:

  - `customer_id` (string)
    Orders of customer to filter

  - `status` (string)
    Status of order to filter
    Enum: "active", "paid", "failed", "action_required", "cancelled", "under_review"

  - `before` (string)
    ISO-8601 timestamp in UTC to filter resources created before this time. Use this to avoid Page drift issue. See Pagination parameters for more details.
    Example: "2025-02-18T12:03:44Z"

  - `after` (string)
    ISO-8601 timestamp in UTC to filter resources created after this time. Use this to avoid Page drift issue. See Pagination parameters for more details.
    Example: "2025-01-18T12:03:44Z"

  - `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 order.
    Example: "order_678a4c88hpAjf"

  - `data.customer_id` (string)
    The unique identifier of customer linked to order.
    Example: "cust_E602dMzgjpDC"

  - `data.document_id` (string)
    The unique identifier of document linked to order. This document entity should contain the required documents to process incoming payments. Refer this [Document](#tag/Document) entity for more details.
    Example: "doc_nYUqLpuYQ0M8"

  - `data.status` (string)
    The status of the Order.
    Enum: "active", "paid", "failed", "action_required", "cancelled", "under_review"

  - `data.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. Supported currencies: USD,EUR and GBP.
    Example: "USD"

  - `data.amount` (number)
    The amount you want to receive, a positive integer representing the smallest currency unit. For example, if the amount is $299.00, then pass 29900 in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295.
    Example: 1000

  - `data.purpose_code` (string)
    Purpose code for why you want to receive this payment
    Example: "P1401"

  - `data.invoice_number` (string)
    Number/Id of the invoice submitted with order.
    Example: "RG12FF590"

  - `data.invoice_description` (string)
    Description about the invoice submitted with order
    Example: "Payment requested for services provided"

  - `data.invoice_amount` (number)
    The amount in cents for which invoice was generated. It can be more  than the amount requested in this order
    Example: 1000

  - `data.reference_number` (string)
    optional identifier to be sent for reconciliations
    Example: "R0001"

  - `data.product` (object)
    Details of the product that the payment is related to.

  - `data.product.name` (string, required)
    Name of the product

  - `data.product.description` (string)
    Description of the product

  - `data.notes` (object)
    Any additional notes for the order
    Example: {"key1":"value1","key2":"value2"}

  - `data.bank_account_details` (object)
    Optional bank account details to associate with the customer for this order. When provided, the bank account will be linked to the customer and associated with this order. Either bic_primary or bic_secondary must be provided when including this field.
    Example: {"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bic_secondary":null,"bank_customer_id":"7189204715"}

  - `data.bank_account_details.account_number` (string, required)
    The bank account number
    Example: "1234567890"

  - `data.bank_account_details.bic_primary` (string,null)
    SWIFT code for the bank account. Will be null if not provided in the request.
    Example: "HDFCINBBDEL"

  - `data.bank_account_details.bic_secondary` (string,null)
    Local routing code for the bank account like IFSC. Will be null if not provided in the request.
    Example: "HDFC0001097"

  - `data.bank_account_details.bank_customer_id` (string,null)
    Optional bank customer identifier provided by the bank
    Example: "7189204715"

  - `data.payment_methods` (array)
    Array of payment methods that should be available for the customer on the checkout page. This field allows you to control which payment options your customers can use to complete the payment. You can specify one or multiple payment methods in the array.
    Enum: "bank_transfer", "pay_via_bank", "card"

  - `data.created_at` (string)
    Timestamp representing when the order was created
    Example: "2021-06-01T12:00:00Z"

  - `data.updated_at` (string)
    Timestamp representing when the order was last updated
    Example: "2021-06-01T12:00:00Z"

  - `data.rfi_documents` (array)
    List of required documents for RFI (Request for Information). This field is only present when the order status is 'action_required', indicating that sanction screening has been triggered and additional documents are required to proceed with the payment.
    Example: [{"rfi_doc_id":"rfidoc_123","name":"Passport"},{"rfi_doc_id":"rfidoc_456","name":"Proof of Address"}]

  - `data.rfi_documents.rfi_doc_id` (string, required)
    Unique identifier for the required RFI document
    Example: "rfidoc_123"

  - `data.rfi_documents.name` (string, required)
    Name/type of the required document
    Example: "Passport"

  - `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):

  - `message` (string)
    Error message.
    Example: "Invalid customer_id"