For the complete documentation index, see llms.txt. This page is also available as Markdown.

Journal Run

Get Journal Runs

get
/apis/je/v1/

This API will retrieve the details of all journal run IDs

Query parameters
page_numberstringOptional

This is optional field. It represents page number.

page_sizestringOptional

This is optional field. It represents how many records available on each page.

Responses
200

Get Journal Runs

application/json
additional_infoarrayRequired

This includes all the details of journal run IDs.

request_idstringRequired

A system-generated request ID

total_recordsintegerRequired

No of total records fetched by this API.

get/apis/je/v1/
GET /apis/je/v1/ HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get Journal Runs

{
  "additional_info": [],
  "journal_run_list": [
    {
      "accounting_period": "2026-1",
      "created_by": "thiyagu@rightrev.com",
      "created_on": 1780412537,
      "currency_code": "CAD",
      "file_id": "sage-int-test##df01e92f-f35c-41ab-9cb4-674c54071c25",
      "file_version": 1,
      "gl_integration_app_name": "SAGE",
      "journal_run_id": 133,
      "journals_agg_fields": [
        {
          "code": "gl_int_location_id",
          "label": "Location ID"
        },
        {
          "code": "order_financial_id",
          "label": "Order Financial ID"
        },
        {
          "code": "revenue_contract_id",
          "label": "Revenue Contract ID"
        },
        {
          "code": "gl_int_department_id",
          "label": "Department ID"
        }
      ],
      "last_modified_by": "thiyagu@rightrev.com",
      "last_modified_on": 1780412728,
      "legal_entity": "400",
      "no_of_journal_entries": 22,
      "posted_to_gl": false,
      "rc_ids": null,
      "state": "Transferred",
      "tenant_id": "sage-int-test",
      "total_credit_amount": 1390.95,
      "total_debit_amount": 1390.95,
      "transfer_currency_type": "functional"
    }
  ],
  "request_id": "sage-int-test",
  "total_records": 99
}

Create Journal Run

post
/apis/je/v1/

This API will be used to initite new journals for all eligible legal entities.

Body
legal_entitystringRequired

Name of the legal entity.

accounting_periodstringRequired

name of the period for which user has initiated journals

rc_idsstring[]Optional

Revenue contract IDs selected for journal transfer.

Responses
200

Create Journal Run

application/json
idintegerRequired

Journal Run ID generated by the system.

messagestringRequired

System will display a message of success or error on journal creation.

post/apis/je/v1/
POST /apis/je/v1/ HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "legal_entity": "100",
  "accounting_period": "2026-5"
}
200

Create Journal Run

{
  "id": 134,
  "message": "Journal Run:134 created"
}

Get Journal Summary

get
/apis/je/v1/{journal_run_id}/summary

This API will retrieve the details of SUMMARY BY GL ACCOUNT section in journal run.

Path parameters
journal_run_idstringRequired

User need to provide Journal Run ID.

Query parameters
page_numberstringOptional

This is optional field. It represents page number.

page_sizestringOptional

This is optional field. It represents how many records available on each page.

Responses
200

Get Journal Summary

application/json
additional_infoarrayRequired

Information related to all additional attributes.

request_idnullRequired

System generated alpha-numeric ID.

total_recordsintegerRequired

No of total records fetched by this API.

get/apis/je/v1/{journal_run_id}/summary
GET /apis/je/v1/{journal_run_id}/summary HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get Journal Summary

{
  "additional_info": [],
  "journal_run_list": [
    {
      "account": "20701",
      "accounting_type": "Contractual Liability",
      "credit": 0,
      "currency_code": "CAD",
      "debit": 1390.95
    },
    {
      "account": "40200",
      "accounting_type": "Contractual Revenue",
      "credit": 1390.95,
      "currency_code": "CAD",
      "debit": 0
    }
  ],
  "request_id": null,
  "total_records": 2
}

Get Journal Detail

get
/apis/je/v1/{journal_run_id}/details

This API will retrieve the details of SUMMARY BY ATTRIBUTES section in journal run.

Path parameters
journal_run_idstringRequired

User need to provide Journal Run ID.

Query parameters
page_numberstringOptional

This is optional field. It represents page number.

page_sizestringOptional

This is optional field. It represents how many records available on each page.

Responses
200

Get Journal Detail

application/json
additional_infoarrayRequired

Information related to all additional attributes.

request_idnullRequired

System generated alpha-numeric ID.

total_recordsintegerRequired

No of total records fetched by this API.

get/apis/je/v1/{journal_run_id}/details
GET /apis/je/v1/{journal_run_id}/details HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get Journal Detail

{
  "additional_info": [],
  "journal_run_list": [
    {
      "account": "20701",
      "accounting_period": "2026-1",
      "accounting_period_name": "2026-1",
      "accounting_type": "Contractual Liability",
      "credit": 0,
      "currency_code": "CAD",
      "debit": 126.45,
      "gl_int_department_id": "500",
      "gl_int_location_id": "401",
      "order_financial_id": "SO0522_RR026_ST.3",
      "revenue_contract_id": "RC-94"
    },
    {
      "account": "20701",
      "accounting_period": "2026-1",
      "accounting_period_name": "2026-1",
      "accounting_type": "Contractual Liability",
      "credit": 0,
      "currency_code": "CAD",
      "debit": 126.45,
      "gl_int_department_id": "500",
      "gl_int_location_id": "401",
      "order_financial_id": "SO0522_RR027_ST.3",
      "revenue_contract_id": "RC-127"
    }
  ],
  "request_id": null,
  "total_records": 22
}

Transfer Journal

put
/apis/je/v1/{journal_run_id}/transfer

This API is used to Transfer journals from Ready to Transfer state.

Path parameters
journal_run_idstringRequired

User need to provide Journal run ID.

Body
file_versionintegerRequired

Version of the file.

Responses
200

Transfer Journal

application/json
additional_infoarrayRequired

Information related to all additional attributes.

request_idstringRequired

System generated alpha-numeric ID.

total_recordsintegerRequired

No of total records fetched by this API.

put/apis/je/v1/{journal_run_id}/transfer
PUT /apis/je/v1/{journal_run_id}/transfer HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "file_version": 1
}
200

Transfer Journal

{
  "additional_info": [],
  "journal_run_list": [
    {
      "accounting_period": "2026-5",
      "created_by": "thiyagu@rightrev.com",
      "created_on": "2026-06-10 17:13:59.723",
      "currency_code": "USD",
      "file_id": "20d94ddc-929a-4d98-8714-fdbea4362fa4",
      "file_version": 1,
      "journal_run_id": 135,
      "last_modified_by": "thiyagu@rightrev.com",
      "last_modified_on": "2026-06-10 17:15:41.256",
      "legal_entity": "100",
      "no_of_journal_entries": 2,
      "state": "Transfer-In-Progress",
      "tenant_id": "sage-int-test",
      "total_credit_amount": 1750,
      "total_debit_amount": 1750
    }
  ],
  "request_id": "20d94ddc-929a-4d98-8714-fdbea4362fa4",
  "total_records": 1
}

Cancel Journal

put
/apis/je/v1/{journal_run_id}/cancel

This API is used to Cancel journal which are in READY TO TRANSFER state.

Path parameters
journal_run_idstringRequired

User need to provide Journal Run ID.

Body
file_versionintegerRequired

Version of the file.

forcebooleanRequired

This is boolean field. User need to provide true or false.

Responses
200

Cancel Journal

application/json
messagestringRequired

System generated message on cancellation.

put/apis/je/v1/{journal_run_id}/cancel
PUT /apis/je/v1/{journal_run_id}/cancel HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "file_version": 1,
  "force": true
}
200

Cancel Journal

{
  "message": "Journal Run:134 cancelled "
}

Post Journal

put
/apis/je/v1/{journal_run_id}

This API is used to Post the journals to GL system.

Path parameters
journal_run_idstringRequired

User need to provide Journal Run ID

Body
posted_to_glbooleanRequired

Boolean field indicating posted to GL or not.

Responses
200

Post Journal

application/json
messagestringRequired

Journal run with id __ got updated successfully.

posted_to_glbooleanRequired

Boolean field indicating posted to GL or not.

request_idstringRequired

Syatem generated alpha-numeric number.

statestringRequired

It will be transferred.

put/apis/je/v1/{journal_run_id}
PUT /apis/je/v1/{journal_run_id} HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "posted_to_gl": true
}
200

Post Journal

{
  "additional_info": [
    {
      "accounting_period": "2026-5",
      "action": "Updation to transferred file with posted_to_gl.",
      "file_name": "85409be3-ca1c-4358-8c8b-afb4641501eb.json",
      "status": "success"
    },
    {
      "accounting_period": "2026-5",
      "file_name": "85409be3-ca1c-4358-8c8b-afb4641501eb.json",
      "state": "Archiving the prior file from transferred path.",
      "status": "success"
    }
  ],
  "message": "Journal run with id 135 got updated successfully.",
  "posted_to_gl": true,
  "request_id": "85409be3-ca1c-4358-8c8b-afb4641501eb",
  "state": "Transferred"
}

Get Journal Download

get
/apis/je/v1/{journal_run_id}/download

This API is used to download journals data.

Path parameters
journal_run_idstringRequired

User need to provide journal run ID.

Responses
200

Get Journal Download

stringOptional
get/apis/je/v1/{journal_run_id}/download
GET /apis/je/v1/{journal_run_id}/download HTTP/1.1
Host: {realm}.{env}.rightrev.cloud/
Accept: */*
200

Get Journal Download

https://dev-rev-engine.s3.amazonaws.com/lineage/<tenant_id>/journal_details/journal_run_133.csv?response-content-disposition=attachment%3B%20filename%3D%22journal_run_133.csv%22&AWSAccessKeyId=XX&Signature=XX&Expires=1781110039

Last updated

Was this helpful?