> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Finmei

> Finmei is an invoicing tool designed to simplify billing processes, allowing users to create and manage invoices and track expenses efficiently.

![Finmei logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/finmei.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=e48468c005cf374649f675772f3fa25b)

* **Category:** accounting
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 24
* **Triggers:** 0
* **Slug:** `FINMEI`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Expense
>
> **Slug:** `FINMEI_CREATE_EXPENSE`
>
> Tool to create a new expense with file upload (receipt or invoice). Use when you need to record an expense with supporting documentation. Requires multipart/form-data submission with file, date, total, currency, and seller information.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> Date of the expense in YYYY-MM-DD format
>
> **file** `object` *required*
>
> Receipt file (PDF or image).
>
> **total** `number` *required*
>
> Total amount of the expense, must be non-negative
>
> **seller** `string` *required*
>
> Name of the seller/vendor from the invoice or receipt
>
> **currency** `string` *required*
>
> Uppercase three-letter ISO 4217 currency code
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Invoice
>
> **Slug:** `FINMEI_CREATE_INVOICE`
>
> Creates a new invoice in Finmei with buyer information and line items. Use this when you need to generate an invoice for a customer. You can specify: - Buyer details (person or company) - Products/services with quantities and prices - Invoice type (regular, VAT, preliminary, credit) - Currency, dates, and custom notes Example: "Create an invoice for Tech Solutions Inc with 3 months of support services at \$99.99/month"
>
> #### Input Parameters
>
> **code** `string`
>
> Optional custom invoice code or reference
>
> **type** `string ("regular_invoice" | "vat_invoice" | "preliminary_invoice" | "preliminary_vat_invoice" | "credit_invoice" | "credit_vat_invoice")`
>
> Invoice type required by API. Valid values: 'regular\_invoice', 'vat\_invoice', 'preliminary\_invoice', 'preliminary\_vat\_invoice', 'credit\_invoice', 'credit\_vat\_invoice'
>
> **buyer** `object`
>
> Buyer object; required by API when not using customer\_id
>
> **notes** `string`
>
> Optional notes to appear on the invoice
>
> **seller** `object`
>
> Seller object if not using default
>
> **series** `string`
>
> Series code/prefix for the invoice
>
> **currency** `string`
>
> ISO 4217 three-letter currency code
>
> **customer** `object`
>
> Inline customer details; mutually exclusive with `customer_id`
>
> **due\_date** `string`
>
> Payment due date (YYYY-MM-DD)
>
> **products** `array`
>
> Products array as required by API
>
> **issue\_date** `string`
>
> Date the invoice was issued (YYYY-MM-DD)
>
> **line\_items** `array`
>
> List of line items for the invoice
>
> **customer\_id** `string`
>
> ID of an existing customer; mutually exclusive with `customer`
>
> **invoice\_date** `string`
>
> Invoice date as expected by the API (YYYY-MM-DD)
>
> **use\_default\_seller\_info** `boolean`
>
> If true, API will use default seller info instead of requiring seller object
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Customer
>
> **Slug:** `FINMEI_DELETE_CUSTOMER`
>
> Deletes a Finmei customer record by its ID.
>
> #### Input Parameters
>
> **customer\_id** `string` *required*
>
> Unique identifier of the customer to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Invoice
>
> **Slug:** `FINMEI_DELETE_INVOICE`
>
> Tool to delete an invoice. Use when you need to remove an existing invoice by its ID.
>
> #### Input Parameters
>
> **invoice\_id** `string` *required*
>
> The unique identifier of the invoice to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Payment
>
> **Slug:** `FINMEI_DELETE_PAYMENT`
>
> Attempts to delete a payment record by its unique identifier. A success response can also be returned after a 404, so it does not necessarily confirm deletion.
>
> #### Input Parameters
>
> **payment\_id** `string` *required*
>
> Unique identifier of the payment to delete. This is typically returned from payment creation or list operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Product
>
> **Slug:** `FINMEI_DELETE_PRODUCT`
>
> Deletes a product from the Finmei catalog by its ID, for example to remove an obsolete or duplicate product.
>
> #### Input Parameters
>
> **product\_id** `string` *required*
>
> Unique identifier of the product to delete. This is the product's ID as returned by list\_products or get\_product operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Expense File
>
> **Slug:** `FINMEI_DOWNLOAD_EXPENSE_FILE`
>
> Tool to download the file associated with an expense. Returns the expense document file (PDF or image). Use when you need to retrieve the actual file content for an expense.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the expense to download the file for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Invoice PDF
>
> **Slug:** `FINMEI_DOWNLOAD_INVOICE_PDF`
>
> Tool to download an invoice as a PDF file. Use when you need to retrieve the PDF version of an invoice.
>
> #### Input Parameters
>
> **invoice\_id** `string` *required*
>
> The unique identifier of the invoice to download as PDF
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Expense by ID
>
> **Slug:** `FINMEI_GET_EXPENSE`
>
> Tool to retrieve a single expense by its ID. Use when you need to get details about a specific expense including date, total, currency, and seller information.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the expense to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Invoice by ID
>
> **Slug:** `FINMEI_GET_INVOICE`
>
> Tool to retrieve a single invoice by its ID. Use when you need full invoice details including buyer, seller, items, amounts, and payment options.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Invoice ID to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Payment
>
> **Slug:** `FINMEI_GET_PAYMENT`
>
> Looks up Finmei payment details using a payment ID, such as after creating a payment.
>
> #### Input Parameters
>
> **payment\_id** `string` *required*
>
> Unique identifier of the payment to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product by ID
>
> **Slug:** `FINMEI_GET_PRODUCT`
>
> Tool to retrieve a product by its ID. Use when you need detailed information about a single product.
>
> #### Input Parameters
>
> **product\_id** `string` *required*
>
> Unique identifier of the product to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Profile
>
> **Slug:** `FINMEI_GET_PROFILE`
>
> Tool to retrieve main information about the business to which the API token is assigned. Use when needing business ID, title, type, address, VAT code, company name, or company code.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Currencies
>
> **Slug:** `FINMEI_LIST_CURRENCIES`
>
> Tool to list all currencies supported by Finmei. Use when you need to retrieve available currency codes before creating transactions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Customers
>
> **Slug:** `FINMEI_LIST_CUSTOMERS`
>
> Lists Finmei customers for browsing or searching, with optional search and sorting. Results are paginated, with 1 to 100 customers per page.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (must be >= 1)
>
> **sort** `string`
>
> Sort order, e.g., 'name\_asc' or 'created\_at\_desc'
>
> **search** `string`
>
> Search term to filter customers by name or email
>
> **per\_page** `integer`
>
> Number of customers per page (1-100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Expenses
>
> **Slug:** `FINMEI_LIST_EXPENSES`
>
> Tool to list all expenses for the business. Use when you need a paginated list of expenses with metadata.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (must be >= 1)
>
> **per\_page** `integer`
>
> Number of expenses per page (1-100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Invoices
>
> **Slug:** `FINMEI_LIST_INVOICES`
>
> Tool to list invoices. Use when you need a paginated list of invoices with basic details.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (must be >= 1)
>
> **per\_page** `integer`
>
> Number of invoices per page (1-100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Payments
>
> **Slug:** `FINMEI_LIST_PAYMENTS`
>
> Lists payment records with optional date filters and limit-and-offset pagination. Results filtered by status are empty. Payments may be drawn from a page of invoices, and pagination is applied to the retrieved results, so the results may be incomplete.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of payments to retrieve (default 20, max 100)
>
> **offset** `integer`
>
> Number of payments to skip for pagination
>
> **status** `string ("pending" | "completed" | "failed")`
>
> Filter payments by status
>
> **end\_date** `string`
>
> Filter payments created on or before this date (ISO 8601 format)
>
> **start\_date** `string`
>
> Filter payments created on or after this date (ISO 8601 format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Products
>
> **Slug:** `FINMEI_LIST_PRODUCTS`
>
> Lists Finmei products for browsing or filtering the catalog. Supports optional name and status filters and pagination, with 1 to 100 products per page.
>
> #### Input Parameters
>
> **name** `string`
>
> Filter products by name substring.
>
> **page** `integer`
>
> Page number for pagination (1-indexed).
>
> **status** `string ("active" | "inactive")`
>
> Filter products by their status.
>
> **per\_page** `integer`
>
> Number of products per page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Customer
>
> **Slug:** `FINMEI_UPDATE_CUSTOMER`
>
> Tool to update an existing customer's details. Use after confirming the customer ID to modify their information.
>
> #### Input Parameters
>
> **name** `string`
>
> Full name of the customer
>
> **email** `string`
>
> Email address of the customer
>
> **phone** `string`
>
> Phone number of the customer
>
> **address** `object`
>
> Mailing address details
>
> **metadata** `object`
>
> Additional metadata for the customer as key-value pairs
>
> **customer\_id** `string` *required*
>
> Unique identifier of the customer to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Expense
>
> **Slug:** `FINMEI_UPDATE_EXPENSE`
>
> Updates an existing expense's date, total, currency, and seller. All four fields are required for each update.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the expense to update. Must be a valid existing expense ID.
>
> **date** `string` *required*
>
> Date of the expense in YYYY-MM-DD format. This field is required.
>
> **total** `number` *required*
>
> Total amount of the expense. Must be non-negative. This field is required.
>
> **seller** `string` *required*
>
> Name of the seller from invoice. This field is required.
>
> **currency** `string` *required*
>
> Uppercase three letter currency code (ISO 4217 format). Example: USD, EUR, GBP. This field is required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Expense File
>
> **Slug:** `FINMEI_UPDATE_EXPENSE_FILE`
>
> Updates the file attachment of an existing expense in Finmei. Use this action when you need to attach or replace a receipt/invoice file for an expense. This endpoint is specifically for updating the file only - use the Update Expense action for updating other expense fields like amount, date, or description. The file is uploaded using multipart/form-data content type and typically should be a PDF or image file of the bill/receipt.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the expense to update the file for. Must be a valid existing expense ID.
>
> **file** `object` *required*
>
> File to upload as the expense attachment (usually PDF or image file of the bill).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Invoice
>
> **Slug:** `FINMEI_UPDATE_INVOICE`
>
> Tool to update an existing invoice in Finmei. Use when you need to modify invoice details such as buyer information, products, dates, or currency.
>
> #### Input Parameters
>
> **code** `string`
>
> Optional custom invoice code or reference
>
> **type** `string ("regular_invoice" | "vat_invoice" | "preliminary_invoice" | "preliminary_vat_invoice" | "credit_invoice" | "credit_vat_invoice")`
>
> Invoice type. Valid values: 'regular\_invoice', 'vat\_invoice', 'preliminary\_invoice', 'preliminary\_vat\_invoice', 'credit\_invoice', 'credit\_vat\_invoice'
>
> **buyer** `object`
>
> Buyer object with customer information
>
> **notes** `string`
>
> Optional notes to appear on the invoice
>
> **seller** `object`
>
> Seller object if not using default
>
> **series** `string`
>
> Series code/prefix for the invoice
>
> **currency** `string`
>
> ISO 4217 three-letter currency code
>
> **due\_date** `string`
>
> Payment due date (alias). Format: YYYY-MM-DD
>
> **products** `array`
>
> Products array with line items for the invoice
>
> **invoice\_id** `string` *required*
>
> Unique identifier of the invoice to update
>
> **invoice\_date** `string`
>
> Date on the invoice. Format: YYYY-MM-DD
>
> **pay\_until\_date** `string`
>
> Payment due date. Format: YYYY-MM-DD
>
> **use\_default\_seller\_info** `boolean`
>
> If true, API will use default seller info instead of requiring seller object
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Product
>
> **Slug:** `FINMEI_UPDATE_PRODUCT`
>
> Updates a product's name, description, price, or currency by ID, requiring at least one update field. Returned details are normalized and may be incomplete or defaulted when the response or subsequent lookup lacks fields.
>
> #### Input Parameters
>
> **name** `string`
>
> Updated name for the product. If provided, replaces the existing product name.
>
> **price** `number`
>
> Updated price for the product in the specified currency. Must be non-negative. If provided, replaces the existing price.
>
> **currency** `string`
>
> Updated currency code for the product price (ISO 4217 format, e.g., USD, EUR, GBP). If provided, replaces the existing currency.
>
> **product\_id** `string` *required*
>
> Unique identifier of the product to update. Must be a valid existing product ID.
>
> **description** `string`
>
> Updated description for the product. If provided, replaces the existing description.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
