Retrieve a transaction

GET

transactions

{transactionId}

curl --request GET \
  --url https://api.slash.com/v2/transactions/{transactionId} \
  --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/transactions/{transactionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/transactions/{transactionId}"

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/transactions/{transactionId}"

	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))

}

{
  "id": "agg_tx_2rj4l7hmrrrcv",
  "date": "2026-08-18T01:00:00.000Z",
  "description": "VENDOR PAYMENT",
  "amountCents": -1250,
  "status": "pending",
  "accountId": "sa_group_primary123",
  "accountSubtype": "cash",
  "category": "card",
  "detailedStatus": "pending",
  "memo": "Invoice 1042",
  "note": "Reconciled with invoice 1042",
  "virtualAccountId": "subaccount_operations123",
  "transferId": "transfer_intent_2rj4l7hmrrrcv",
  "originalCurrency": {
    "code": "<string>",
    "amountCents": 123,
    "conversionRate": 123
  },
  "details": {
    "cardId": "<string>",
    "merchant": {
      "description": "<string>",
      "categoryCode": "<string>",
      "location": {
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "zip": "<string>"
      }
    },
    "orderId": "<string>",
    "referenceNumber": "<string>",
    "authorizedAt": "2023-11-07T05:31:56Z",
    "declineReason": "<string>",
    "approvalReason": "<string>",
    "providerAuthorizationId": "<string>",
    "cashback": {
      "amountCents": 123,
      "rate": 123
    },
    "fxFee": {
      "amountCents": 123
    }
  }
}

Read Transfers and transactions to understand how transfer instructions relate to account impacts.

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]+$

Path Parameters

transactionId

string

required

Transaction id with the agg_tx_ prefix.

Response

The transaction.

Card activity with merchant and authorization data in details. This is the card variant of the unified Transaction model: category is always card and detailedStatus is limited to card lifecycle states.

string

required

Transaction id.

Example:

"agg_tx_2rj4l7hmrrrcv"

date

string<date-time>

required

Posting date, or creation date while pending or failed.

Example:

"2026-08-18T01:00:00.000Z"

description

string

required

Statement descriptor when one was supplied; otherwise a Slash-generated display description.

Example:

"VENDOR PAYMENT"

amountCents

integer

required

Signed USD account impact in cents. Debits are negative.

Example:

-1250

status

enum<string>

required

Coarse transaction state.

Available options:

pending,

posted,

failed

accountId

string

required

Account containing the transaction.

Example:

"sa_group_primary123"

accountSubtype

enum<string>

required

Balance type affected by the transaction.

Available options:

cash,

credit

Example:

"cash"

category

enum<string>

required

Available options:

card

detailedStatus

enum<string>

required

Exact lifecycle state of a card transaction.

Available options:

pending,

canceled,

failed,

settled,

declined,

refund,

reversed,

dispute

memo

string

Human-readable payment memo, when present. For transfers, this is the request's top-level description.

Example:

"Invoice 1042"

note

string

User-editable private note, when present.

Example:

"Reconciled with invoice 1042"

virtualAccountId

string

Virtual account containing the transaction, when applicable.

Example:

"subaccount_operations123"

transferId

string

The transfer that produced this transaction, if any. Uses the transfer_intent_ prefix.

Example:

"transfer_intent_2rj4l7hmrrrcv"

originalCurrency

object

Original currency details when the transaction was converted. Despite the historical amountCents field name, the amount uses the original currency's native minor unit.

Hide child attributes

originalCurrency.code

string

required

originalCurrency.amountCents

integer

required

Amount in the original currency's native minor unit.

originalCurrency.conversionRate

number

required

details

object

Card, merchant, and authorization data for a card transaction.

Hide child attributes

details.cardId

string

details.merchant

object

Hide child attributes

details.merchant.description

string

required

details.merchant.categoryCode

string

required

details.merchant.location

object

Hide child attributes

details.merchant.location.city

string

required

details.merchant.location.state

string

required

details.merchant.location.country

string

required

details.merchant.location.zip

string

required

details.orderId

string

details.referenceNumber

string

details.authorizedAt

string<date-time>

details.declineReason

string

details.approvalReason

string

details.providerAuthorizationId

string

details.cashback

object

Hide child attributes

details.cashback.amountCents

integer

required

Cashback earned, in cents.

details.cashback.rate

number

required

details.fxFee

object

Hide child attributes

details.fxFee.amountCents

integer

required

Foreign transaction fee charged, in cents.

⌘I

Retrieve a transaction

curl --request GET \
  --url https://api.slash.com/v2/transactions/{transactionId} \
  --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/transactions/{transactionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/transactions/{transactionId}"

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/transactions/{transactionId}"

	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))

}

{
  "id": "agg_tx_2rj4l7hmrrrcv",
  "date": "2026-08-18T01:00:00.000Z",
  "description": "VENDOR PAYMENT",
  "amountCents": -1250,
  "status": "pending",
  "accountId": "sa_group_primary123",
  "accountSubtype": "cash",
  "category": "card",
  "detailedStatus": "pending",
  "memo": "Invoice 1042",
  "note": "Reconciled with invoice 1042",
  "virtualAccountId": "subaccount_operations123",
  "transferId": "transfer_intent_2rj4l7hmrrrcv",
  "originalCurrency": {
    "code": "<string>",
    "amountCents": 123,
    "conversionRate": 123
  },
  "details": {
    "cardId": "<string>",
    "merchant": {
      "description": "<string>",
      "categoryCode": "<string>",
      "location": {
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "zip": "<string>"
      }
    },
    "orderId": "<string>",
    "referenceNumber": "<string>",
    "authorizedAt": "2023-11-07T05:31:56Z",
    "declineReason": "<string>",
    "approvalReason": "<string>",
    "providerAuthorizationId": "<string>",
    "cashback": {
      "amountCents": 123,
      "rate": 123
    },
    "fxFee": {
      "amountCents": 123
    }
  }
}

Accounts

Virtual accounts

Contacts

Transfers

Transactions

Retrieve a transaction

Authorizations

Headers

Path Parameters

Response