> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Moss

> Read Moss spend management data: expenses (card transactions, invoices, reimbursements) with accounting detail, bank transactions, receipt files, and chart of accounts

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0 (client credentials).
* **Connection**: Veryfront mints machine-to-machine tokens from the client ID and secret in the project's environment variables.
* **Docs**: [https://developers.getmoss.com/](https://developers.getmoss.com/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable             | Required | Description                                                                                                                            |
| -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `MOSS_CLIENT_ID`     | Yes      | Moss API Key ID (starts with kid\_), created by an admin under Settings > Platform > API Keys [Docs](https://developers.getmoss.com/). |
| `MOSS_CLIENT_SECRET` | Yes      | Moss API Secret Key (starts with sk\_) paired with the Key ID [Docs](https://developers.getmoss.com/).                                 |

## Setup

1. **Create an API key**: As a Moss admin, go to Settings > Platform > API Keys in the Moss app and create a key. You receive a Key ID (kid\_...) and a Secret Key (sk\_...). Only admins can create API keys.
2. **Set environment variables**: Set MOSS\_CLIENT\_ID to the Key ID and MOSS\_CLIENT\_SECRET to the Secret Key.
3. **Verify access**: Run List Bank Accounts or List Expenses. Access tokens are minted automatically via the OAuth2 client\_credentials grant at [https://public-api.getmoss.com/oauth2/token](https://public-api.getmoss.com/oauth2/token) (valid for 1 hour, scope 'read').

* This connector requests the 'read' scope only; Moss write endpoints (creating suppliers, dimensions, or dimension items) require scope 'write' and are not included.
* Rate limits: 180 read requests/minute and 20 write requests/minute per company.
* The Search Bank Transactions and Search Receipt Files tools use POST search-query endpoints but are read-only.

Provider API reference: [https://developers.getmoss.com/](https://developers.getmoss.com/)

## Tools

| Tool                     | Access | Description                                                                                                                                      |
| ------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| List Expenses            | Read   | List expenses - card transactions, invoices, and reimbursements - with status, export status, and date filters; the basis for accounting exports |
| Search Bank Transactions | Read   | Search bank transactions of a Moss bank account within a booking-date window (read-only search query)                                            |
| List Bank Accounts       | Read   | List the company's bank accounts in Moss (use the IDs with Search Bank Transactions)                                                             |
| Search Receipt Files     | Read   | Find receipt and invoice files attached to specific expenses (read-only search query); download via the returned file IDs                        |
| List Expense Accounts    | Read   | List the chart of accounts used for ledger posting, for mapping expenses into your accounting system                                             |
| List Suppliers           | Read   | List supplier master data for spend-by-vendor analysis and accounting export enrichment                                                          |
| Get File Content         | Read   | Download the binary content of a receipt or invoice file (application/octet-stream) using a file ID from Search Receipt Files                    |
| Get Bank Account Balance | Read   | Get the current balance of a Moss bank account for liquidity overviews                                                                           |
| List Tax Rates           | Read   | List VAT/tax rate master data for mapping expenses into the accounting system                                                                    |

## Example prompts

* List Moss expenses with export status READY\_FOR\_EXPORT and summarize them by type and supplier.
* Show this month's Moss card transactions and break down spend by status.
* For my most recent approved Moss expenses, check which ones have receipt files attached.