Quickstarts

export AX_KEY="ax_live_…"

# 1. List your chart of accounts to grab account IDs.
curl -H "Authorization: Bearer $AX_KEY" \
  https://axerity.com/api/v1/accounts | jq '.data[] | { id, code, name }'

# 2. Post a $1,200 sale: debit Cash, credit Service Revenue.
curl -X POST https://axerity.com/api/v1/transactions \
  -H "Authorization: Bearer $AX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-05-24",
    "memo": "Hosting sale — Acme Co",
    "reference": "INV-1024",
    "lines": [
      { "account": "01HW…CASH",    "debit":  "1200.00" },
      { "account": "01HW…REVENUE", "credit": "1200.00" }
    ]
  }'

# 3. Pull the income statement.
curl -H "Authorization: Bearer $AX_KEY" \
  https://axerity.com/api/v1/reports/income_statement

export AX_KEY="ax_live_…"
FILE="./contract.pdf"
SIZE=$(stat -c%s "$FILE")

# 1. Initiate.
RESP=$(curl -s -X POST https://axerity.com/api/v1/files \
  -H "Authorization: Bearer $AX_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"name\": \"contract.pdf\",
    \"content_type\": \"application/pdf\",
    \"size_bytes\": \"$SIZE\"
  }")

FILE_ID=$(echo $RESP | jq -r .id)
URL=$(echo $RESP | jq -r .upload.url)

# 2. Upload bytes directly to S3.
curl -X PUT "$URL" \
  -H "Content-Type: application/pdf" \
  -H "x-amz-server-side-encryption: AES256" \
  --data-binary @"$FILE"

# 3. Finalize.
curl -X POST "https://axerity.com/api/v1/files/$FILE_ID/finalize" \
  -H "Authorization: Bearer $AX_KEY"