---
title: "Retrieves a specific journal using a unique journal Id."
method: GET
path: "/Journals/{JournalID}"
tags: ["Accounting"]
---

# Retrieves a specific journal using a unique journal Id.

`GET /Journals/{JournalID}`

## Path parameters

- `JournalID` string, uuid, required

## Response `200`

Success - return response of type Journals array with specified Journal

- Journals
  - `Warnings` ValidationError[] — Displays array of warning messages from the API
    - `Message` string — Validation error message
  - `Journals` Journal[]
    - `JournalID` string, uuid — Xero identifier
    - `JournalDate` string — Date the journal was posted
    - `JournalNumber` integer — Xero generated journal number
    - `CreatedDateUTC` string — Created date UTC format
    - `Reference` string — reference field for additional indetifying information
    - `SourceID` string, uuid — The identifier for the source transaction (e.g. InvoiceID)
    - `SourceType` 'ACCREC' | 'ACCPAY' | 'ACCRECCREDIT' | 'ACCPAYCREDIT' | 'ACCRECPAYMENT' | 'ACCPAYPAYMENT' | 'ARCREDITPAYMENT' | 'APCREDITPAYMENT' | 'CASHREC' | 'CASHPAID' | 'TRANSFER' | 'ARPREPAYMENT' | 'APPREPAYMENT' | 'AROVERPAYMENT' | 'APOVERPAYMENT' | 'EXPCLAIM' | 'EXPPAYMENT' | 'MANJOURNAL' | 'PAYSLIP' | 'WAGEPAYABLE' | 'INTEGRATEDPAYROLLPE' | 'INTEGRATEDPAYROLLPT' | 'EXTERNALSPENDMONEY' | 'INTEGRATEDPAYROLLPTPAYMENT' | 'INTEGRATEDPAYROLLCN' — The journal source type. The type of transaction that created the journal
    - `JournalLines` JournalLine[] — See JournalLines
      - `JournalLineID` string, uuid — Xero identifier for Journal
      - `AccountID` string, uuid — See Accounts
      - `AccountCode` string — See Accounts
      - `AccountType` 'BANK' | 'CURRENT' | 'CURRLIAB' | 'DEPRECIATN' | 'DIRECTCOSTS' | 'EQUITY' | 'EXPENSE' | 'FIXED' | 'INVENTORY' | 'LIABILITY' | 'NONCURRENT' | 'OTHERINCOME' | 'OVERHEADS' | 'PREPAYMENT' | 'REVENUE' | 'SALES' | 'TERMLIAB' | 'PAYG' — See Account Types
      - `AccountName` string — See AccountCodes
      - `Description` string — The description from the source transaction line item. Only returned if populated.
      - `NetAmount` number, double — Net amount of journal line. This will be a positive value for a debit and negative for a credit
      - `GrossAmount` number, double — Gross amount of journal line (NetAmount + TaxAmount).
      - `TaxAmount` number, double — Total tax on a journal line
      - `TaxType` string — The tax type from taxRates
      - `TaxName` string — see TaxRates
      - `TrackingCategories` TrackingCategory[] — Optional Tracking Category – see Tracking. Any JournalLine can have a maximum of 2 <TrackingCategory> elements.
        - `TrackingCategoryID` string, uuid — The Xero identifier for a tracking category e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
        - `TrackingOptionID` string, uuid — The Xero identifier for a tracking option e.g. dc54c220-0140-495a-b925-3246adc0075f
        - `Name` string — The name of the tracking category e.g. Department, Region (max length = 100)
        - `Option` string — The option name of the tracking option e.g. East, West (max length = 100)
        - `Status` 'ACTIVE' | 'ARCHIVED' | 'DELETED' — The status of a tracking category
        - `Options` TrackingOption[] — See Tracking Options
          - `TrackingOptionID` string, uuid — The Xero identifier for a tracking option e.g. ae777a87-5ef3-4fa0-a4f0-d10e1f13073a
          - `Name` string — The name of the tracking option e.g. Marketing, East (max length = 100)
          - `Status` 'ACTIVE' | 'ARCHIVED' | 'DELETED' — The status of a tracking option
          - `TrackingCategoryID` string, uuid — Filter by a tracking category e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9

---

[API](https://skmtc.net/xeroapi/apis/xero-accounting-api.md) · [All operations](https://skmtc.net/xeroapi/apis/xero-accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xeroapi/xero-accounting-api/versions/dc231cafd8de/schema)