InnFinn for Developers

Advances ​

List of Advances ​

Endpoint: GET /api/advances

Retrieve a list of all advances. This endpoint allows to filter the results by page and limit the number of records returned.

URL ​

http
GET https://portal.innfinn.com/api/advances

Optional Parameters ​

  • page (integer) Page number for pagination, default is 1.
  • limit (integer ) Number of records per page, default is 10.

Response Schema ​

  • id (string) Advance ID.
  • status (string) Status of the advance (e.g., new, approved, rejected, paid, partial_repaid, repaid).
  • currency (string) Currency of the advance (e.g., AED).
  • amount (integer) Total amount of the advance in the smallest currency unit (e.g., cents, fils).
  • repaid_amount (integer) Amount that has been repaid in the smallest currency unit (e.g., cents, fils).
  • created_at (string) Date and time the advance was created.
  • confirmed_at (string) Date and time the advance was confirmed.
  • approved_at (string) Date and time the advance was approved.
  • rejected_at (string) Date and time the advance was rejected.
  • paid_at (string) Date and time the advance was paid.
  • repaid_at (string) Date and time the advance was repaid.

Example Request ​

json
{
  "page": 1,
  "limit": 2
}

Example Response ​

json
{
  "response": [
    {
      "id": "25051354097341",
      "status": "repaid",
      "currency": "AED",
      "amount": 10000,
      "repaid_amount": 16000,
      "created_at": "2025-05-13 21:54:09",
      "confirmed_at": "2025-05-13 21:54:11",
      "approved_at": "2025-05-13 21:54:11",
      "rejected_at": null,
      "paid_at": "2023-06-15 14:30:00",
      "repaid_at": "2023-06-15 19:30:00"
    },
    {
      "id": "25051353118081",
      "status": "paid",
      "currency": "AED",
      "amount": 10000,
      "repaid_amount": 0,
      "created_at": "2025-05-13 21:53:11",
      "confirmed_at": "2025-05-13 21:53:25",
      "approved_at": "2025-05-13 21:53:25",
      "rejected_at": null,
      "paid_at": "2023-06-15 14:30:00",
      "repaid_at": null
    },
    {
      "id": "25051308145749",
      "status": "approved",
      "currency": "AED",
      "amount": 10000,
      "repaid_amount": 0,
      "created_at": "2025-05-13 18:08:14",
      "confirmed_at": "2025-05-13 18:08:16",
      "approved_at": "2025-05-13 18:08:16",
      "rejected_at": null,
      "paid_at": null,
      "repaid_at": null
    },
    {
      "id": "25051308003216",
      "status": "partial_repaid",
      "currency": "AED",
      "amount": 10000,
      "repaid_amount": 4000,
      "created_at": "2025-05-13 18:08:00",
      "confirmed_at": "2025-05-13 18:08:02",
      "approved_at": "2025-05-13 18:08:02",
      "rejected_at": null,
      "paid_at": "2023-06-15 14:30:00",
      "repaid_at": null
    },
    {
      "id": "25051307373342",
      "status": "repaid",
      "currency": "AED",
      "amount": 10000,
      "repaid_amount": 12000,
      "created_at": "2025-05-13 18:07:37",
      "confirmed_at": "2025-05-13 18:07:38",
      "approved_at": "2025-05-13 18:07:38",
      "rejected_at": null,
      "paid_at": "2023-06-15 14:30:00",
      "repaid_at": "2023-06-15 19:30:00"
    }
  ]
}