What is the Attachments API?
The Attachments API v2 allows you to retrieve files that have been uploaded and associated with Clara entities, such as transactions, invoices, or reimbursement requests. Attachments may include receipts, invoices, approval files, or any supporting documentation. With this API, you can:- List all uploaded files
- Retrieve metadata for a specific attachment
- Download the attachment as a base64-encoded file
Available Endpoints
Get a list of attachments
Use this endpoint to list all attachments available to your company. You can optionally filter by entity type or related ID.Endpoint
GET /v2/attachments
cURL Request
cURL
Sample JSON Response
JSON
Get Single Attachment information with the pre signed URL
Use this to retrieve detailed metadata for a specific attachment by its UUID. This includes file name, type, entity association, and creation date.Endpoint
GET /v2/attachments/{uuid}
cURL Request
cURL
Get Attachment File as Base64
Use this endpoint to download the file in base64 format, allowing you to render or store the file securely in your systemEndpoint
GET /v2/attachments/{uuid}/base64
cURL Request
cURL
Sample JSON Response
JSON
💡 Tip: You can use the base64 content to display the file inline in web or mobile apps, or decode and store it in your system. **⚠️ Note: **Attachments can be large. Avoid retrieving large batches unless necessary. Use pagination and lazy-loading in UIs where possible.