Actions49
- Account (Paid-Through) Actions
- Artifact Actions
- Audit XML Actions
- Company Actions
- Document Actions
- Document Type Actions
- Expense Actions
- Income Actions
- Ledger Number Actions
- Partner Actions
- Payment Actions
- Pulse Actions
- Salary Actions
- Tax Actions
- Tax Code Actions
- VAT Category Actions
Expense → Search Artifact
AI-generatedSummary
Searches for an existing expense artifact (document image) by filename, file size in bytes, and associated company IDs, returning matching artifacts if any exist.
Inputs
- Filename (required) — The exact filename of the expense artifact to search for.
- Size (Bytes) (required) — The size of the file in bytes to match the artifact's size.
- Company IDs (required) — A comma-separated list of company IDs to limit the search scope to specified companies.
Output shape
a list of matching expense artifact records (array) if found, otherwise an empty list
The search is done by posting the name, size, and company IDs to the '/2/expenses/artifact-search/' API endpoint. Company IDs input is parsed from a comma-separated string into an array before the search.
Examples
Example 1: Search expense artifact usage
Provide the filename, size, and comma-separated company IDs to find matching expense artifacts in the selected companies.