Create expense

curl --request POST \ --url https://staging-api.usetyms.com/v1/adam/create/expense \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "date": "2026-03-03", "currency": "NGN", "document_number": "EXP-220", "narration": "Team lunch — client meeting", "customer": "c9b8a7d6e5f4438290a1b2c3d4e5f6c0", "payment_category": "Main Operating Account", "items": [ { "item_name": "Meals and entertainment", "quantity": 1, "selling_price": 18500, "category": "Meals & Entertainment" } ] } '

{ "status": "success", "message": "Expenses imported successfully", "data": [ { "uuid": "a0b1c2d3e4f5428290a1b2c3d4e5f6b1", "transaction_type": "expenses", "status": "paid" } ] }

Authorizations

X-API-Key

string

header

default:your_tyms_sk_or_partner_key

required

Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.

Body

application/json

date

string<date>

required

Expense date.

items

object[]

required

Minimum array length: 1

Hide child attributes

items.item_name

string

required

Line label. Alias: name.

items.quantity

number

required

Quantity sold or purchased.

items.selling_price

number

required

Unit price. On bills this is unit cost. Alias: price.

items.category

string

required

Required. Revenue, expense, or inventory account — name, uuid, or account code.

items.description

string

Optional line description.

items.tax

number

Tax rate as a percentage (e.g. 7.5 = 7.5%). Preferred over tax_uuid.

items.tax_uuid

string

Optional tax record uuid instead of tax percentage.

items.withholding_tax

number

Withholding tax (WHT) rate as a percentage.

items.withholding_tax_uuid

string

Optional WHT uuid instead of withholding_tax percentage.

items.discount

number

Line discount value.

items.discount_type

enum<string>

percent or amount / fixed.

Available options:

percent,

amount,

fixed

items.is_inventory

boolean

true if the line affects stock.

items.uuid

string

Existing inventory item uuid when linking stock.

payment_category

string

required

Cash or bank name paid from. Payment is assumed in full from the line totals — do not send amount_paid (that key is only for invoices and bills).

currency

string

customer

string

document_number

string

Alias: bill_no.

narration

string

is_prepayment

boolean

Set true (or 1) to create a prepaid_expenses record instead of a regular expense. The expense amount is deferred and recognized monthly over prepayment_duration.

prepayment_duration

integer

Number of months to recognize the prepaid expense over. Required when is_prepayment is true.

prepayment_account

string

Asset account name for the prepaid balance. Defaults to the business prepaid expenses account.

Response

Expense created

status

string

required

Example:

"success"

message

string

required

data

any

Single resource, array of resources, statement sections, or async job metadata — see each operation's example.

Overview

Authentication

OAuth

Chart of accounts

Invoices

Bills

Expenses

Income

Journals

Contacts

Banks

Bank transactions

Inventory

Fixed Assets

Quotes

Purchase Orders

Departments

Projects

Branches

Reports

Distribution Partners

Authorizations

Body

Response