Expenses

Track business expenses. Each expense links to a vendor and an uploaded file (receipt/invoice).

Use cases: Use the Expenses API to automate expense recording from receipt scanning apps or bank feeds.

GET/expenses

List all expenses.

Query Parameters

Name	Type	Description
`search`	string	Free-text search across relevant fields.
`page`	number	Page number (default 1).
`limit`	number	Items per page (default 50).

Request

curl -X GET "https://api.glance.co.il/expenses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": [
    {
      "id": 1,
      "vendor": {
        "visibleId": 1,
        "name": "Supplier Co"
      },
      "title": "Office Supplies",
      "total": 450,
      "tax": 65.38,
      "deductableTax": 65.38,
      "date": "2024-03-15",
      "currency": "ILS",
      "isEquipment": false,
      "createdAt": "2024-03-15T11:00:00Z"
    }
  ],
  "pagination": {
    "total": 78,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  }
}

GET/expenses/id/:id

Get a single expense by ID.

Path Parameters

Name	Type		Description
`id`	number	required	The expense ID.

Request

curl -X GET "https://api.glance.co.il/expenses/id/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": {
    "id": 1,
    "vendor": {
      "visibleId": 1,
      "name": "Supplier Co"
    },
    "title": "Office Supplies",
    "total": 450,
    "tax": 65.38,
    "deductableTax": 65.38,
    "date": "2024-03-15",
    "documentNumber": "INV-2024-789",
    "currency": "ILS",
    "isEquipment": false,
    "notes": "Q1 office supply restock",
    "file": {
      "visibleId": 10,
      "url": "https://files.glance.app/10.pdf"
    },
    "createdAt": "2024-03-15T11:00:00Z"
  }
}

POST/expenses/create

Create a new expense.

Body Parameters

Name	Type		Description
`vendorId`	number	required	Visible ID of the vendor.
`fileId`	number	required	ID of the uploaded receipt / invoice file.
`date`	string	required	Expense date (YYYY-MM-DD).
`total`	number	required	Total expense amount (must be positive).
`tax`	number	required	Tax amount (must be >= 0).
`deductableTax`	number	required	Deductible tax amount (must be >= 0).
`title`	string		Expense title / description.
`notes`	string		Additional notes.
`documentNumber`	string		External document / invoice number.
`currency`	string		3-letter currency code (default ILS).
`isEquipment`	boolean		Whether this expense is for equipment / fixed asset (default false).

Request

curl -X POST "https://api.glance.co.il/expenses/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vendorId": 0,
  "fileId": 0,
  "date": "example_date",
  "total": 0,
  "tax": 0,
  "deductableTax": 0,
  "title": "example_title",
  "notes": "example_notes",
  "documentNumber": "example_documentNumber",
  "currency": "example_currency",
  "isEquipment": true
}'

Response

{
  "data": {
    "id": 15,
    "vendorId": 1,
    "title": "Software License",
    "total": 1200,
    "tax": 174.36,
    "deductableTax": 174.36,
    "date": "2024-03-20",
    "currency": "ILS",
    "isEquipment": false,
    "createdAt": "2024-03-20T14:30:00Z"
  }
}

PUT/expenses/edit/:id

Update an existing expense.

Path Parameters

Name	Type		Description
`id`	number	required	The expense ID.

Body Parameters

Name	Type	Description
`vendorId`	number	Visible ID of the vendor.
`fileId`	number	Receipt / invoice file ID.
`date`	string	Expense date (YYYY-MM-DD).
`total`	number	Total expense amount.
`tax`	number	Tax amount.
`deductableTax`	number	Deductible tax amount.
`title`	string	Expense title.
`notes`	string	Additional notes.
`documentNumber`	string	External document number.
`currency`	string	3-letter currency code.
`isEquipment`	boolean	Equipment flag.

Request

curl -X PUT "https://api.glance.co.il/expenses/edit/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vendorId": 0,
  "fileId": 0,
  "date": "example_date",
  "total": 0,
  "tax": 0,
  "deductableTax": 0,
  "title": "example_title",
  "notes": "example_notes",
  "documentNumber": "example_documentNumber",
  "currency": "example_currency",
  "isEquipment": true
}'

Response

{
  "data": {
    "id": 1,
    "title": "Office Supplies (Updated)",
    "total": 500
  }
}

DELETE/expenses/delete/:id

Delete an expense.

Path Parameters

Name	Type		Description
`id`	number	required	The expense ID.

Request

curl -X DELETE "https://api.glance.co.il/expenses/delete/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": {
    "success": true
  }
}