Get a Transaction by ID - Bookeeping.ai Docs

GET

transactions

{id}

Get a Transaction by ID

curl --request GET \
  --url https://api.bookeeping.ai/public-api/v1/transactions/{id} \
  --header 'Authorization: Bearer <token>'

{
  "message": "<string>",
  "metaData": {
    "warnings": [
      "<string>"
    ]
  },
  "data": {
    "_id": "<string>",
    "projectId": "<string>",
    "currency": "<string>",
    "totalAmount": 123,
    "transactionDate": "2023-11-07T05:31:56Z",
    "paymentMethod": {},
    "source": {},
    "isReconciled": true,
    "nonProfitAllocations": [
      {
        "percentage": 123,
        "program": {
          "_id": "<string>",
          "name": "<string>",
          "status": "PLANNING",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "hexColor": "<string>"
        },
        "grant": {
          "_id": "<string>",
          "name": "<string>",
          "status": "ACTIVE",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "hexColor": "<string>",
          "funder": {
            "_id": "<string>",
            "accountName": "<string>",
            "accountNumber": "<string>",
            "email": "jsmith@example.com",
            "phone": "<string>",
            "type": "customer"
          }
        },
        "note": "<string>"
      }
    ],
    "entries": [
      {
        "id": "<string>",
        "amount": 123,
        "type": "DEBIT",
        "parentCategory": "INCOME",
        "category": {
          "_id": "<string>",
          "name": "<string>",
          "emoji": "<string>",
          "parentCategory": "INCOME",
          "number": "<string>",
          "group": "<string>"
        },
        "isMain": true,
        "note": "<string>"
      }
    ],
    "classes": [
      {
        "_id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "emoji": "<string>",
        "color": "<string>"
      }
    ],
    "attachmentsIds": [
      "<string>"
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "refNo": "<string>",
    "originalAmount": 123,
    "originalCurrency": "<string>",
    "counterParty": {
      "_id": "<string>",
      "accountName": "<string>",
      "accountNumber": "<string>",
      "email": "jsmith@example.com",
      "phone": "<string>",
      "type": "customer"
    },
    "account": {
      "_id": "<string>",
      "accountType": "Depository",
      "accountName": "<string>",
      "accountNumber": "<string>"
    },
    "nonProfitGrantId": "<string>",
    "attachedTransactionId": "<string>"
  }
}

Authorizations

Authorization

string

header

required

API key for authentication. Get your key from the Dashboard > Settings > API Access.

Path Parameters

string

required

The id of the transaction. Expected to be a valid object id like 666666666666666666666666

Response

Get a Transaction by ID executed successfully

message

string

Success message

metaData

object

Show child attributes

metaData.warnings

string[]

Any validation warnings

data

object

Show child attributes

data._id

string

required

The id of the transaction

data.projectId

string

required

The project id of the transaction

data.currency

string

required

The currency of the transaction

data.totalAmount

number

required

The total amount of the transaction. Same as the sum of the Total Credit = Total Debit.

data.transactionDate

string<date-time>

required

The transaction date of the transaction

data.paymentMethod

object

required

The payment method of the transaction

data.source

object

required

The source of the transaction

data.isReconciled

boolean

required

The reconciliation status of the transaction

data.nonProfitAllocations

object[]

required

The non profit allocations of the transaction

Show child attributes

data.nonProfitAllocations.percentage

number

required

The percentage of the non profit allocation

data.nonProfitAllocations.program

object

Show child attributes

data.nonProfitAllocations.program._id

string

required

The id of the program

data.nonProfitAllocations.program.name

string

required

The name of the program

data.nonProfitAllocations.program.status

enum<string>

required

The status of the program

Available options:

PLANNING,

ACTIVE,

COMPLETED,

CANCELLED

data.nonProfitAllocations.program.createdAt

string<date-time>

required

The created at of the program

data.nonProfitAllocations.program.updatedAt

string<date-time>

required

The updated at of the program

data.nonProfitAllocations.program.hexColor

string | null

data.nonProfitAllocations.grant

object

Show child attributes

data.nonProfitAllocations.grant._id

string

required

The id of the grant

data.nonProfitAllocations.grant.name

string

required

The name of the grant

data.nonProfitAllocations.grant.status

enum<string>

required

The status of the grant

Available options:

ACTIVE,

COMPLETED,

CANCELLED

data.nonProfitAllocations.grant.createdAt

string<date-time>

required

The created at of the grant

data.nonProfitAllocations.grant.updatedAt

string<date-time>

required

The updated at of the grant

data.nonProfitAllocations.grant.hexColor

string | null

data.nonProfitAllocations.grant.funder

object

Show child attributes

data.nonProfitAllocations.grant.funder._id

string

required

The id of the counterparty

data.nonProfitAllocations.grant.funder.accountName

string | null

data.nonProfitAllocations.grant.funder.accountNumber

string | null

data.nonProfitAllocations.grant.funder.email

string<email> | null

data.nonProfitAllocations.grant.funder.phone

string | null

data.nonProfitAllocations.grant.funder.type

enum<string> | null

Available options:

customer,

vendor,

both

data.nonProfitAllocations.note

string | null

data.entries

object[]

required

The entries of the transaction

Show child attributes

data.entries.id

string

required

The id of the entry

data.entries.amount

number

required

The amount of the entry

data.entries.type

enum<string>

required

The type of the entry

Available options:

DEBIT,

CREDIT

data.entries.parentCategory

enum<string> | null

Available options:

INCOME,

OTHER_INCOME,

SALES,

EXPENSE,

DEPRECIATION,

COST_OF_GOODS_SOLD,

OTHER_EXPENSE,

OVERHEAD,

CURRENT_ASSET,

FIXED_ASSET,

INVENTORY,

NON_CURRENT_ASSET,

PREPAYMENT,

LIABILITY,

CURRENT_LIABILITY,

NON_CURRENT_LIABILITY,

TAX_PAYABLE,

TAX,

EQUITY,

OTHER

data.entries.category

object

Show child attributes

data.entries.category._id

string

required

The id of the category

data.entries.category.name

string

required

The name of the category

data.entries.category.emoji

string | null

data.entries.category.parentCategory

enum<string> | null

Available options:

INCOME,

OTHER_INCOME,

SALES,

EXPENSE,

DEPRECIATION,

COST_OF_GOODS_SOLD,

OTHER_EXPENSE,

OVERHEAD,

CURRENT_ASSET,

FIXED_ASSET,

INVENTORY,

NON_CURRENT_ASSET,

PREPAYMENT,

LIABILITY,

CURRENT_LIABILITY,

NON_CURRENT_LIABILITY,

TAX_PAYABLE,

TAX,

EQUITY,

OTHER

data.entries.category.number

string | null

data.entries.category.group

string | null

data.entries.isMain

boolean | null

data.entries.note

string | null

data.classes

object[]

required

The classes of the transaction

Show child attributes

data.classes._id

string

required

The id of the class

data.classes.name

string

required

The name of the class

data.classes.description

string | null

data.classes.emoji

string | null

data.classes.color

string | null

data.attachmentsIds

string[]

required

The attachments ids of the transaction

data.createdAt

string<date-time>

required

The created at of the transaction

data.updatedAt

string<date-time>

required

The updated at of the transaction

data.refNo

string | null

data.originalAmount

number | null

data.originalCurrency

string | null

data.counterParty

object

Show child attributes

data.counterParty._id

string

required

The id of the counterparty

data.counterParty.accountName

string | null

data.counterParty.accountNumber

string | null

data.counterParty.email

string<email> | null

data.counterParty.phone

string | null

data.counterParty.type

enum<string> | null

Available options:

customer,

vendor,

both

data.account

object

Show child attributes

data.account._id

string

required

The id of the account

data.account.accountType

enum<string>

required

The type of the account

Available options:

Depository,

Credit,

Loan,

Investment,

Other

data.account.accountName

string | null

data.account.accountNumber

string | null

data.nonProfitGrantId

string | null

data.attachedTransactionId

string | null

Delete a TransactionDelete a Transaction

⌘I

Get a Transaction by ID

curl --request GET \
  --url https://api.bookeeping.ai/public-api/v1/transactions/{id} \
  --header 'Authorization: Bearer <token>'

{
  "message": "<string>",
  "metaData": {
    "warnings": [
      "<string>"
    ]
  },
  "data": {
    "_id": "<string>",
    "projectId": "<string>",
    "currency": "<string>",
    "totalAmount": 123,
    "transactionDate": "2023-11-07T05:31:56Z",
    "paymentMethod": {},
    "source": {},
    "isReconciled": true,
    "nonProfitAllocations": [
      {
        "percentage": 123,
        "program": {
          "_id": "<string>",
          "name": "<string>",
          "status": "PLANNING",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "hexColor": "<string>"
        },
        "grant": {
          "_id": "<string>",
          "name": "<string>",
          "status": "ACTIVE",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "hexColor": "<string>",
          "funder": {
            "_id": "<string>",
            "accountName": "<string>",
            "accountNumber": "<string>",
            "email": "jsmith@example.com",
            "phone": "<string>",
            "type": "customer"
          }
        },
        "note": "<string>"
      }
    ],
    "entries": [
      {
        "id": "<string>",
        "amount": 123,
        "type": "DEBIT",
        "parentCategory": "INCOME",
        "category": {
          "_id": "<string>",
          "name": "<string>",
          "emoji": "<string>",
          "parentCategory": "INCOME",
          "number": "<string>",
          "group": "<string>"
        },
        "isMain": true,
        "note": "<string>"
      }
    ],
    "classes": [
      {
        "_id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "emoji": "<string>",
        "color": "<string>"
      }
    ],
    "attachmentsIds": [
      "<string>"
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "refNo": "<string>",
    "originalAmount": 123,
    "originalCurrency": "<string>",
    "counterParty": {
      "_id": "<string>",
      "accountName": "<string>",
      "accountNumber": "<string>",
      "email": "jsmith@example.com",
      "phone": "<string>",
      "type": "customer"
    },
    "account": {
      "_id": "<string>",
      "accountType": "Depository",
      "accountName": "<string>",
      "accountNumber": "<string>"
    },
    "nonProfitGrantId": "<string>",
    "attachedTransactionId": "<string>"
  }
}

Routes

Authorizations

Path Parameters

Response