Response Format

At Railz, a Report refers to a response object hierarchy. Each API endpoint that retrieves data from an Accounting Service Provider returns a response with one or more Reports.

Each Report has a meta and a data parameter:

  • meta is an object that contains a summary of the report such as data type, reporting period, etc.
  • data is an array of one or more objects containing the relevant data types.

Report Meta

All responses related to accounting data include a meta object containing the following information:

  • reportId: The report's unique id.
  • startDate: Date from which the report data begins in the format: YYYY-MM-DD.
  • endDate: Date from which the report data ends in the format: YYYY-MM-DD.
  • serviceName: The accounting service name provided in the query.
  • businessName: The business name provided in the query.
  • reportFrequency: The reporting period requested.
  • currency: The default currency the business used.
  • accountingMethod: Specifies cash or accrual report. Applies to financial statements only.
  • createdAt: The date/time the report was created by the accounting service provider.
  • updatedAt: The date/time when the data was last updated by Railz.

An example meta object would look like this:

"meta": {
    "reportId": "60000000c6115a0a166e2222",
    "startDate": "2020-01-01T00:00:00",
    "endDate": "2020-12-31T00:00:00",
    "serviceName": "quickbooks",
    "businessName": "Demo Business",
    "reportFrequency": "year",
    "accountingMethod": "accrual",    
    "currency": "CAD",
    "createdAt": "2020-12-31T00:00:00",
    "updatedAt": "2021-01-16T21:14:44"
}

📘

reportFrequency, currency, startDate, and endDate are not always returned.