Help Page Home - Journals
GET Journal/id
Return a single journal transaction detail record.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| WsAccessKey | The Web Service access key for this user and file which allows access to the API for the associated file (found in File - Settings). Using OAuth authentication mechanism is the preferred method to allow API access. | string |
Optional. Legacy authentication method and only required if not using OAuth. OAuth is preferred. |
| FileId | Specifies the file id of the file to perform the operation upon. | integer |
Required |
| id | Journal Id | integer |
Required |
Body Parameters
None.
Response Information
Resource Description
JournalDetail| Name | Description | Type | Additional information |
|---|---|---|---|
| Items | The items associated with this journal transaction. | Collection of JournalItem |
Required |
| Notes | Textual notes set by the user. | string |
None. |
| TransactionId | The Id/key of the journal/transaction. This data is returned only and cannot be added or updated when issuing a POST or PUT. | integer |
None. |
| LastUpdatedId | A data field used to check concurreny when performing updates. This data is returned only and used for concurrency checking when performing an update/PUT. | string |
None. |
| TransactionDate | Date of this transaction. | date |
Required |
| Summary | Journal summary. | string |
None. |
| Currency | The currrency code of the amounts. Eg. AUD. | string |
None. |
| FxRate | FXRate (Foreign exchange rate) applied to this invoice. | decimal number |
None. |
| AutoPopulateFxRate | Determines whether the FxRate is automatically populated using the Fx feed. | boolean |
None. |
| Reference | Journal reference | string |
None. |
| JournalContactId | The Id/key of the journal transaction's contact. | integer |
None. |
| ContactFirstName | Contact first name. This data is returned only and cannot be added or updated when issuing a POST or PUT. | string |
None. |
| ContactLastName | Contact last name. This data is returned only and cannot be added or updated when issuing a POST or PUT. | string |
None. |
| ContactOrganisationName | Contact organisation name. This data is returned only and cannot be added or updated when issuing a POST or PUT. | string |
None. |
| RequiresFollowUp | Journal transaction requires follow up | boolean |
None. |
| Tags | List of tags associated with this resource. | Collection of string |
None. |
| CreatedDateUtc | The date and time this resource was created in UTC. This data is returned only and cannot be added or updated when issuing a POST or PUT. | date |
None. |
| LastModifiedDateUtc | The date and time this resource was last modified in UTC. This data is returned only and cannot be added or updated when issuing a POST or PUT. | date |
None. |
| _links | Hypermedia links. Contains contextual links to possible next actions related to this resource. Only present in responses. This data is not to be sent to the server. | Collection of Link |
None. |
Response Formats
application/json, text/json
Sample:
{
"Items": [
{
"Type": "Credit",
"AccountId": 321,
"TaxCode": "G1",
"Amount": 10.0,
"_links": []
}
],
"Notes": "Test journal note",
"TransactionId": 5093684,
"LastUpdatedId": "AAAAAAAKgc=",
"TransactionDate": "2015-01-24T00:00:00",
"Summary": "Test Journal entry 1",
"Currency": "AUD",
"FxRate": 1.0,
"AutoPopulateFxRate": false,
"Reference": "123",
"JournalContactId": 987,
"ContactFirstName": "Joe",
"ContactLastName": "Smith",
"ContactOrganisationName": "Joes Toys",
"RequiresFollowUp": false,
"Tags": [
"Note",
"Supplier",
"Toys"
],
"CreatedDateUtc": "2025-11-01T12:17:57.3932263Z",
"LastModifiedDateUtc": "2025-11-02T12:17:57.3932263Z",
"_links": [
{
"rel": "self",
"href": "https://api.saasu.com/Journal/5093684?FileId=123",
"method": "GET",
"title": null
},
{
"rel": "list",
"href": "https://api.saasu.com/Journals?FileId=123",
"method": "GET",
"title": null
},
{
"rel": "update",
"href": "https://api.saasu.com/Journal/5093684?FileId=123",
"method": "PUT",
"title": null
},
{
"rel": "delete",
"href": "https://api.saasu.com/Journal/5093684?FileId=123",
"method": "DELETE",
"title": null
}
]
}
application/xml, text/xml
Sample:
<JournalDetail xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<_links>
<Link>
<rel>self</rel>
<href>https://api.saasu.com/Journal/5093684?FileId=123</href>
<method>GET</method>
</Link>
<Link>
<rel>list</rel>
<href>https://api.saasu.com/Journals?FileId=123</href>
<method>GET</method>
</Link>
<Link>
<rel>update</rel>
<href>https://api.saasu.com/Journal/5093684?FileId=123</href>
<method>PUT</method>
</Link>
<Link>
<rel>delete</rel>
<href>https://api.saasu.com/Journal/5093684?FileId=123</href>
<method>DELETE</method>
</Link>
</_links>
<TransactionId>5093684</TransactionId>
<LastUpdatedId>AAAAAAAKgc=</LastUpdatedId>
<TransactionDate>2015-01-24T00:00:00</TransactionDate>
<Summary>Test Journal entry 1</Summary>
<Currency>AUD</Currency>
<FxRate>1</FxRate>
<AutoPopulateFxRate>false</AutoPopulateFxRate>
<Reference>123</Reference>
<JournalContactId>987</JournalContactId>
<ContactFirstName>Joe</ContactFirstName>
<ContactLastName>Smith</ContactLastName>
<ContactOrganisationName>Joes Toys</ContactOrganisationName>
<RequiresFollowUp>false</RequiresFollowUp>
<Tags>
<string>Note</string>
<string>Supplier</string>
<string>Toys</string>
</Tags>
<CreatedDateUtc>2025-11-01T12:17:57.3932263Z</CreatedDateUtc>
<LastModifiedDateUtc>2025-11-02T12:17:57.3932263Z</LastModifiedDateUtc>
<Items>
<JournalItem>
<_links />
<Type>Credit</Type>
<AccountId>321</AccountId>
<TaxCode>G1</TaxCode>
<Amount>10.00</Amount>
</JournalItem>
</Items>
<Notes>Test journal note</Notes>
</JournalDetail>