Skip to main content

End of Day API Documentation

Overview

The End of Day API provides endpoints for retrieving end-of-day transaction summaries and reports for accounts and tenants.

Base URL

/api/v1/eod

Authentication

All endpoints require authentication using an API key in the request headers:
  • X-API-KEY: Your API key

Endpoints

Get EOD Reports

Retrieves a list of end-of-day reports with optional filtering and pagination. Endpoint: GET /fetch Headers:
  • X-API-KEY (optional): API key for authentication
Query Parameters:
  • accountId: Account ID (comma-separated for multiple accounts)
  • tenantId: Tenant ID (comma-separated for multiple tenants)
  • eodReferenceId: EOD reference ID (comma-separated for multiple references)
  • startedAt: Start date and time (ISO-8601 format)
  • completedAt: End date and time (ISO-8601 format)
  • page: Page number (default: 0)
  • size: Page size (default: 20)
  • sort: Sort field and direction (e.g., “createdAt,desc”)
Response:

Error Responses

All endpoints may return the following error responses: 401 Unauthorized
404 Not Found

Notes

  • All timestamps are in ISO-8601 format
  • The EOD reference ID format is “EOD-YYYYMMDD-XXX” (e.g., “EOD-20240526-001”)
  • If only startedAt is provided, the end time will be set to the next day
  • If only completedAt is provided, the start time will be set to the previous day
  • Platform admins can view EOD reports for all tenants
  • Tenant users can only view EOD reports for their own tenant
  • The EOD report includes:
    • Total number of transactions
    • Total transaction amount
    • Total credit amount
    • Total debit amount
    • Account and tenant information
    • Processing status and timestamps