Get a posting line
Finance module
GET/posting-lines/{posting_line_id}postingLines.get
A Universal Posting Line (Bible tab 36): the one export shape, projected to every accounting platform. Returns one posting line with its `ETag`. A posting line the caller may not see returns 404.
- Requires the capability finance.journal.read.
- OAuth scopes: finance.
- Error statuses: 400, 401, 404, 429. Errors are RFC 9457 problem details.
Path and query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| posting_line_id | string (uuid) | Yes | Identifier of the posting line. |
| fields | Fields | No | Sparse fieldset: a comma-separated list of top-level fields to return. `id` is always returned.Constraints: pattern ^[a-z_][a-z0-9_]*(,[a-z_][a-z0-9_]*)*$ |
Response 200: PostingLine
| Field | Type | Required | Description |
|---|---|---|---|
| org_id | string (uuid) | Yes | Identifier of the owning organization, derived from the parent row and never accepted from the caller. |
| date | string (date) | Yes | Date the cost or revenue is recognized. |
| account_code | GlAccountCode | Yes | GL account code from the fixed chart in `xpms.dim_gl_account` (Section 3.11).Constraints: pattern ^[0-9]{4}$ |
| cost_center_id | CostCenterCode | null | Yes | |
| urid | UridAtAnyGrain | null | Yes | |
| vendor_id | string (uuid) | null | Yes | Identifier of the vendor organization; null for revenue. |
| item_id | ItemId | Yes | Catalog item identifier `{URID}-{ORG}-{SEQ}` (Section 3.6).Constraints: pattern ^[0-9]000\.[0-9]{2}\.[0-9]{2}-[A-Z0-9]+-[0-9]+$ |
| description | string | Yes | Sentence-case line description.Constraints: length 1 to 300 |
| quantity | number | null | Yes | Quantity. |
| unit_basis | UnitCode | Yes | Unit basis from the controlled unit list in `xpms.dim_unit_alias`.Constraints: pattern ^[a-z][a-z0-9_-]*$ |
| amount_minor | integer (int64) | null | Yes | Signed amount; negative for credits. Integer minor units of the resource currency; null means unpriced, never zero. |
| tax_type | TaxType | Yes | Tax type from the Universal Posting Line specification (Bible tab 36).Constraints: pattern ^[A-Z0-9][A-Za-z0-9&'/.()-]*( [A-Za-z0-9&'/.()-]+)*$ |
| currency | string | Yes | ISO 4217 currency code of every money field.Constraints: pattern ^[A-Z]{3}$ |
| external_ref | string | null | Yes | Invoice, card transaction or record identifier.Constraints: length 1 to 300 |
| line_state | SharedState | Yes | A value from the shared finance and commercial state vocabulary (Bible tab 37): the five core states plus declared domain extensions.Constraints: pattern ^[A-Z0-9][A-Za-z0-9&'/.()-]*( [A-Za-z0-9&'/.()-]+)*$ |
| posting_line_id | string (uuid) | Yes | Identifier of the posting line. |
| project_id | string (uuid) | null | Yes | Identifier of the project. |
{
"org_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"date": "2026-10-08",
"account_code": "5400",
"cost_center_id": "CC-VENUE",
"urid": "4000.01",
"vendor_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"item_id": "4000.01.01-XPMS-001",
"description": "Stage deck rental for opening weekend.",
"quantity": 24,
"unit_basis": "each",
"amount_minor": 108000,
"tax_type": "Tax on Purchases",
"currency": "USD",
"external_ref": "INV-2026-0042",
"line_state": "Committed",
"posting_line_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
"project_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f"
}Code samples
curl -X GET "$XOS_BASE_URL/posting-lines/0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f" \
-H "Authorization: Bearer $XOS_API_KEY"const { data, etag } = await xos.postingLines.get("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f");response = xos.posting_lines.get("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f")xos posting-lines get 0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f