List accounting entries

GET

accounting

entries

curl --request GET \
  --url https://api.slash.com/v2/accounting/entries \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/accounting/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/accounting/entries"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/accounting/entries"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "id": "accounting_entry_2rj4l7hmrrrcv",
      "connectionId": "accounting_connection_2rj4l7hmrrrcv",
      "type": "unknown",
      "status": "in_review",
      "statusUpdatedAt": "2026-09-19T14:05:22.000Z",
      "date": "2026-09-18",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "source": {
        "type": "transaction",
        "id": "agg_tx_2rj4l7hmrrrcv"
      },
      "transactionIds": [
        "agg_tx_2rj4l7hmrrrcv"
      ],
      "lineItems": [
        {
          "id": "accounting_line_item_2rj4l7hmrrrcv",
          "type": "fixed",
          "amount": {
            "amount": 123,
            "currency": "<string>"
          },
          "splitIndex": 0,
          "dimensions": {
            "account": {
              "id": "accounting_account_2rj4l7hmrrrcv",
              "name": "6100 Software Subscriptions"
            },
            "class": {
              "id": "accounting_class_3sk5m8inssscw",
              "name": "Engineering"
            }
          },
          "customFields": {
            "cf_cost_center": "CC-100"
          },
          "description": "AWS hosting",
          "transactionId": "agg_tx_2rj4l7hmrrrcv"
        }
      ],
      "lineItemLevelDimensions": [
        "account",
        "class"
      ],
      "entryLevelDimensions": [
        "department"
      ],
      "unsupportedDimensions": [
        "customer"
      ],
      "customFields": {
        "cf_approved_by": "jane@acme.com"
      },
      "attachments": [
        {
          "id": "accounting_attachment_2rj4l7hmrrrcv",
          "documentId": "st_2rj4l7hmrrrcv",
          "filename": "receipt-4471.pdf",
          "status": "pending_sync",
          "contentType": "application/pdf"
        }
      ],
      "createdAt": "2026-09-18T20:11:02.000Z",
      "updatedAt": "2026-09-19T14:05:22.000Z",
      "memo": "AWS hosting, September",
      "externalId": "1234",
      "externalUrl": "https://app.qbo.intuit.com/app/expense?txnId=1234",
      "lastSyncError": {
        "code": "qbo_invalid_account_type",
        "message": "The selected account type cannot be used for this type of transaction.",
        "title": "Invalid account type",
        "suggestion": "Use an Expense, Cost of Goods Sold, or Other Current Asset type account instead."
      }
    }
  ],
  "metadata": {
    "count": 1,
    "nextCursor": "<string>"
  }
}

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Query Parameters

connectionId

string

The accounting connection to read. Optional when the legal entity has exactly one connection; required (connection_id_required) when it has several. List them at GET /v2/accounting/connections.

cursor

string

The opaque metadata.nextCursor value from the previous page. It carries that page's filters, page size and ordering, so pass it on its own; see Pagination.

limit

integer

Number of items per page, from 1 to 100. The page size is carried inside metadata.nextCursor, so later pages keep the same size unless limit is passed again to change it.

Required range: 1 <= x <= 100

status

enum<string>

Return only entries in this status.

Available options:

in_review,

ready_to_sync,

pending_sync,

syncing,

synced,

archived,

failed

sourceType

enum<string>

Return only entries created from transactions, or only from bills.

Available options:

transaction,

bill

transactionId

string

Return the entry that covers one transaction (agg_tx_ prefix). Can't be combined with billId, and combines only with status.

billId

string

Return the entry for one bill (bill_ prefix). Can't be combined with transactionId, and combines only with status.

cardId

string

Return only entries for transactions on one card (c_ prefix). Bill entries have no card, so they are never matched.

cardGroupId

string

Return only entries for transactions on cards in one card group (card_group_ prefix).

virtualAccountId

string

Return only entries for transactions on one virtual account (subaccount_ prefix).

currency

string

Return only entries whose source transaction was in this ISO-4217 currency, for example EUR for foreign-currency card spend.

Pattern: ^[A-Z]{3}$

dateFrom

string<date>

Return only entries with an accounting date on or after this YYYY-MM-DD date.

dateTo

string<date>

Return only entries with an accounting date on or before this YYYY-MM-DD date.

Response

A page of entries.

items

AccountingEntry · object[]

required

Hide child attributes

items.id

string

required

Entry id with the accounting_entry_ prefix.

Example:

"accounting_entry_2rj4l7hmrrrcv"

items.connectionId

string

required

The accounting connection the entry belongs to.

Example:

"accounting_connection_2rj4l7hmrrrcv"

items.type

enum<string>

required

What the entry represents on the platform. expense_card and expense_card_refund come from card transactions; bank_transfer, bank_deposit, and expense from account transactions; journal_entry from transactions posted as journals; bill is the accounts-payable bill and bill_payment the transaction that settles one. unknown entries have not yet been classified.

Available options:

unknown,

expense,

bank_transfer,

bank_deposit,

journal_entry,

expense_card,

expense_card_refund,

bill_payment,

bill

items.status

enum<string>

required

in_review until a user or rule marks it ready; ready_to_sync when coding is complete; pending_sync and syncing while a sync is queued or in flight; synced once the platform holds it; failed when the platform rejected it (see lastSyncError); archived when excluded from the books.

Available options:

in_review,

ready_to_sync,

pending_sync,

syncing,

synced,

archived,

failed

items.statusUpdatedAt

string<date-time>

required

When status last changed.

Example:

"2026-09-19T14:05:22.000Z"

items.date

string<date>

required

Accounting date as YYYY-MM-DD: the settlement date of the source transaction or the invoice date of the bill.

Example:

"2026-09-18"

items.amount

Money · object

required

Net amount in minor units. Negative for money leaving the account (expenses, bill payments) and positive for money arriving. On a bill's entry it is the bill's total, which is positive.

Hide child attributes

items.amount.amount

integer

required

Amount in the currency's minor units.

items.amount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.source

object

required

What the entry was created from.

Hide child attributes

items.source.type

enum<string>

required

transaction entries reference a transaction; bill entries reference a bill from GET /v2/bills/{billId}.

Available options:

transaction,

bill

items.source.id

string

required

The transaction (agg_tx_) or bill (bill_) id. For transaction entries it is one of transactionIds.

Example:

"agg_tx_2rj4l7hmrrrcv"

items.transactionIds

string[]

required

Every transaction the entry covers. Usually one; internal transfers and card repayments combine two.

Example:

["agg_tx_2rj4l7hmrrrcv"]

items.lineItems

AccountingLineItem · object[]

required

Ordered fixed lines first, then editable lines by splitIndex.

Hide child attributes

items.lineItems.id

string

required

Line item id with the accounting_line_item_ prefix.

Example:

"accounting_line_item_2rj4l7hmrrrcv"

items.lineItems.type

enum<string>

required

fixed lines are set by Slash from the connection's account mappings and cannot be recoded. editable lines carry the dimensions you code.

Available options:

fixed,

editable

items.lineItems.amount

Money · object

required

Signed amount in minor units. Debits are positive and credits negative, so the lines of an entry sum to zero.

Hide child attributes

items.lineItems.amount.amount

integer

required

Amount in the currency's minor units.

items.lineItems.amount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.lineItems.splitIndex

integer

required

Position of the line among the entry's editable lines; 0 for unsplit entries.

Example:

0

items.lineItems.dimensions

object

required

The line's coding, keyed by dimension key (see GET /v2/accounting/dimensions). Only dimensions with a value are present.

Hide child attributes

items.lineItems.dimensions.{key}

object

Hide child attributes

items.lineItems.dimensions.{key}.id

string

required

The dimension value id.

Example:

"accounting_account_2rj4l7hmrrrcv"

items.lineItems.dimensions.{key}.name

string

The value's display name at read time.

Example:

"6100 Software Subscriptions"

Example:

{
  "account": {
    "id": "accounting_account_2rj4l7hmrrrcv",
    "name": "6100 Software Subscriptions"
  },
  "class": {
    "id": "accounting_class_3sk5m8inssscw",
    "name": "Engineering"
  }
}

items.lineItems.customFields

object

required

Raw values of line-item level custom fields, keyed by the field's fieldKey from GET /v2/accounting/dimensions. Value type follows the field's fieldType: strings, numbers, booleans, or arrays of option values for multiselect.

Example:

{ "cf_cost_center": "CC-100" }

items.lineItems.description

string

Line memo sent to the platform.

Example:

"AWS hosting"

items.lineItems.transactionId

string

For transaction entries, the transaction this line settles. Entries that combine several transactions carry one fixed line per transaction.

Example:

"agg_tx_2rj4l7hmrrrcv"

items.lineItemLevelDimensions

string[]

required

For bill entries, the dimension keys coded per line item. Dimensions not listed take the same value on every line. Empty for transaction entries.

Example:

["account", "class"]

items.entryLevelDimensions

string[]

required

Dimension keys the platform records once per entry rather than per line item. Every line item carries the same value for these, and a split cannot code them differently across its lines.

Example:

["department"]

items.unsupportedDimensions

string[]

required

Dimension keys the platform does not accept for this entry type. Any value set on them is dropped at sync time.

Example:

["customer"]

items.customFields

object

required

Raw values of entry level custom fields, keyed by the field's fieldKey from GET /v2/accounting/dimensions.

Example:

{ "cf_approved_by": "jane@acme.com" }

items.attachments

AccountingAttachment · object[]

required

Hide child attributes

items.attachments.id

string

required

Attachment id with the accounting_attachment_ prefix.

Example:

"accounting_attachment_2rj4l7hmrrrcv"

items.attachments.documentId

string

required

The underlying document.

Example:

"st_2rj4l7hmrrrcv"

items.attachments.filename

string

required

Example:

"receipt-4471.pdf"

items.attachments.status

enum<string>

required

pending_sync until the entry has synced and the file has been pushed; synced once the platform holds a copy; failed when the push was rejected.

Available options:

pending_sync,

synced,

failed

items.attachments.contentType

string

MIME type of the file.

Example:

"application/pdf"

items.createdAt

string<date-time>

required

Example:

"2026-09-18T20:11:02.000Z"

items.updatedAt

string<date-time>

required

Example:

"2026-09-19T14:05:22.000Z"

items.memo

string

Memo sent to the platform.

Example:

"AWS hosting, September"

items.externalId

string

The platform's id for the synced record. Present once status is synced.

Example:

"1234"

items.externalUrl

string<uri>

A link to the record in the platform, when the platform provides one.

Example:

"https://app.qbo.intuit.com/app/expense?txnId=1234"

items.lastSyncError

object

Why the most recent sync attempt failed. Present while status is failed.

Hide child attributes

items.lastSyncError.code

string

required

Snake_case code from Slash's accounting error catalog, or sync_error when the failure isn't one Slash recognizes.

Example:

"qbo_invalid_account_type"

items.lastSyncError.message

string

required

What went wrong, in words you can show a user. For unrecognized failures this is the platform's own explanation when it gives one.

Example:

"The selected account type cannot be used for this type of transaction."

items.lastSyncError.title

string

required

Short summary of the failure.

Example:

"Invalid account type"

items.lastSyncError.suggestion

string

required

How to fix it.

Example:

"Use an Expense, Cost of Goods Sold, or Other Current Asset type account instead."

metadata

PaginationMetadata · object

required

Hide child attributes

metadata.count

integer

required

Number of items in this page.

Required range: x >= 0

metadata.nextCursor

string

Opaque cursor for the next page. Omitted on the final page.

⌘I

List accounting entries

curl --request GET \
  --url https://api.slash.com/v2/accounting/entries \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/accounting/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/accounting/entries"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/accounting/entries"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "id": "accounting_entry_2rj4l7hmrrrcv",
      "connectionId": "accounting_connection_2rj4l7hmrrrcv",
      "type": "unknown",
      "status": "in_review",
      "statusUpdatedAt": "2026-09-19T14:05:22.000Z",
      "date": "2026-09-18",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "source": {
        "type": "transaction",
        "id": "agg_tx_2rj4l7hmrrrcv"
      },
      "transactionIds": [
        "agg_tx_2rj4l7hmrrrcv"
      ],
      "lineItems": [
        {
          "id": "accounting_line_item_2rj4l7hmrrrcv",
          "type": "fixed",
          "amount": {
            "amount": 123,
            "currency": "<string>"
          },
          "splitIndex": 0,
          "dimensions": {
            "account": {
              "id": "accounting_account_2rj4l7hmrrrcv",
              "name": "6100 Software Subscriptions"
            },
            "class": {
              "id": "accounting_class_3sk5m8inssscw",
              "name": "Engineering"
            }
          },
          "customFields": {
            "cf_cost_center": "CC-100"
          },
          "description": "AWS hosting",
          "transactionId": "agg_tx_2rj4l7hmrrrcv"
        }
      ],
      "lineItemLevelDimensions": [
        "account",
        "class"
      ],
      "entryLevelDimensions": [
        "department"
      ],
      "unsupportedDimensions": [
        "customer"
      ],
      "customFields": {
        "cf_approved_by": "jane@acme.com"
      },
      "attachments": [
        {
          "id": "accounting_attachment_2rj4l7hmrrrcv",
          "documentId": "st_2rj4l7hmrrrcv",
          "filename": "receipt-4471.pdf",
          "status": "pending_sync",
          "contentType": "application/pdf"
        }
      ],
      "createdAt": "2026-09-18T20:11:02.000Z",
      "updatedAt": "2026-09-19T14:05:22.000Z",
      "memo": "AWS hosting, September",
      "externalId": "1234",
      "externalUrl": "https://app.qbo.intuit.com/app/expense?txnId=1234",
      "lastSyncError": {
        "code": "qbo_invalid_account_type",
        "message": "The selected account type cannot be used for this type of transaction.",
        "title": "Invalid account type",
        "suggestion": "Use an Expense, Cost of Goods Sold, or Other Current Asset type account instead."
      }
    }
  ],
  "metadata": {
    "count": 1,
    "nextCursor": "<string>"
  }
}

Accounts

Virtual accounts

Contacts

Transfers

Transactions

Documents

Bills

Accounting

List accounting entries

Authorizations

Headers

Query Parameters

Response