Skip to main content
GET
/
v1
/
expense-reports
List Expense Reports
curl --request GET \
  --url https://api.spirii.com/reimbursement/v1/expense-reports \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "companyName": "Example Company Inc.",
      "id": 42,
      "period": {
        "year": 2026,
        "monthIndex": 0
      },
      "totalAmountInCents": 123,
      "totalConsumptionInWattHours": 123,
      "currency": "EUR",
      "emailAddressList": [
        "manager1@email.com",
        "manager2@email.com"
      ],
      "invalidInformation": {
        "awaitingExpenseReportList": [
          123
        ],
        "companyCustomer": {
          "customerCrmId": "<string>",
          "name": "<string>",
          "invalidFields": [
            "<string>"
          ]
        },
        "supplierCustomer": {
          "customerCrmId": "<string>",
          "name": "<string>",
          "invalidFields": [
            "<string>"
          ]
        },
        "invalidBeneficiary": {
          "customerCrmId": "<string>",
          "expenseIds": [
            "<string>"
          ]
        },
        "kycNotPassed": true,
        "missingReimbursementRates": [
          {
            "locationId": 123,
            "locationName": "<string>",
            "cdrEndDates": [
              "2023-11-07T05:31:56Z"
            ]
          }
        ],
        "recipientList": [
          {
            "customerCrmId": "<string>",
            "name": "<string>",
            "invalidFields": [
              "<string>"
            ]
          }
        ]
      }
    }
  ],
  "pagination": {
    "currentPage": 3,
    "itemCount": 20,
    "itemsPerPage": 25,
    "totalItems": 70,
    "totalPages": 3
  }
}

Authorizations

​
Authorization
string
header
required

Authorization via a JWT bearer token.

Query Parameters

​
customerCrmId
integer

Filter Expense Reports by specific Fleet Customer ID.

Example:

4567

​
status
enum<string>

Filter Expense Reports by specific status.

Active is for current month. Pending is await approval. Approved means approved, but no funds transferred (if applicable). FundsReceived means transfer of funds was registered (if applicable).

Status of the Expense Report.

Available options:
Active,
Pending,
Approved,
FundsReceived
​
limit
integer
default:20

Maximum number of items to return per page.

Required range: 1 <= x <= 500
​
page
integer
default:1

Page number, starting at 1.

Required range: x >= 1
​
sortBy
enum<string>

Field to sort the list of Expense Reports by.

Available options:
id,
period,
status
​
sortDirection
enum<string>
default:DESC

The ordering direction.

Available options:
ASC,
DESC

Response

Returns a paginated list of expense reports.

​
data
object[]
required
read-only

The items on the current page.

​
pagination
object
required

Pagination metadata for navigating result pages.