Skip to main content
-50%Limited offerfor 3 months

Looking for the legacy API v1?v1

The previous version is deprecated but still available for existing integrations.

View v1 docs

API Reference

Complete reference for the Holded REST API. All endpoints use JSON and require Bearer token authentication.

🔒

Authentication

Bearer <api-key>
{ }

OpenAPI spec

openapi.json

Sales

Invoices

Sales invoice management

18 endpoints
POST/api/v2/invoicesPOST/api/v2/invoices/{invoiceId}/paymentsPOST/api/v2/invoices/{invoiceId}/approvePOST/api/v2/invoices/{invoiceId}/attachmentsPOST/api/v2/invoices/{invoiceId}/sendPUT/api/v2/invoices/{invoiceId}PUT/api/v2/invoices/{invoiceId}/pipelineGET/api/v2/invoices/{invoiceId}/attachmentsGET/api/v2/invoicesGET/api/v2/invoices/{invoiceId}GET/api/v2/invoices/{invoiceId}/attachments/{attachmentId}GET/api/v2/invoices/{invoiceId}/pdfDELETE/api/v2/invoices/{invoiceId}POST/api/v2/invoices/bulk/cancelPOST/api/v2/invoices/bulk/approvePOST/api/v2/invoices/{invoiceId}/cancelGET/api/v2/invoices/find-by-numberDELETE/api/v2/invoices

Recurring Invoices

Recurring invoice management

7 endpoints
POST/api/v2/recurring-invoicesPOST/api/v2/recurring-invoices/{invoiceRecurringId}/skipPUT/api/v2/recurring-invoices/{invoiceRecurringId}GET/api/v2/recurring-invoicesGET/api/v2/recurring-invoices/{invoiceRecurringId}GET/api/v2/recurring-invoices/{invoiceRecurringId}/scheduleDELETE/api/v2/recurring-invoices/{invoiceRecurringId}

Sales Receipts

Sales receipt management

13 endpoints
POST/api/v2/sales-receiptsPOST/api/v2/sales-receipts/{salesReceiptId}/paymentsPOST/api/v2/sales-receipts/{salesReceiptId}/approvePOST/api/v2/sales-receipts/{salesReceiptId}/attachmentsPOST/api/v2/sales-receipts/{salesReceiptId}/sendPUT/api/v2/sales-receipts/{salesReceiptId}PUT/api/v2/sales-receipts/{salesReceiptId}/pipelineGET/api/v2/sales-receipts/{salesReceiptId}/attachmentsGET/api/v2/sales-receiptsGET/api/v2/sales-receipts/{salesReceiptId}GET/api/v2/sales-receipts/{salesReceiptId}/attachments/{attachmentId}GET/api/v2/sales-receipts/{salesReceiptId}/pdfDELETE/api/v2/sales-receipts/{salesReceiptId}

Receipt Notes

Receipt note management

13 endpoints
POST/api/v2/receipt-notes/{receiptNoteId}/approvePOST/api/v2/receipt-notes/{receiptNoteId}/attachmentsPOST/api/v2/receipt-notesPOST/api/v2/receipt-notes/{receiptNoteId}/paymentsPOST/api/v2/receipt-notes/{receiptNoteId}/sendPUT/api/v2/receipt-notes/{receiptNoteId}PUT/api/v2/receipt-notes/{receiptNoteId}/pipelineGET/api/v2/receipt-notes/{receiptNoteId}/attachmentsGET/api/v2/receipt-notesGET/api/v2/receipt-notes/{receiptNoteId}GET/api/v2/receipt-notes/{receiptNoteId}/attachments/{attachmentId}GET/api/v2/receipt-notes/{receiptNoteId}/pdfDELETE/api/v2/receipt-notes/{receiptNoteId}

Estimates

Estimate management

14 endpoints
POST/api/v2/estimatesPOST/api/v2/estimates/{estimateId}/acceptPOST/api/v2/estimates/{estimateId}/attachmentsPOST/api/v2/estimates/{estimateId}/rejectPOST/api/v2/estimates/{estimateId}/sendPOST/api/v2/estimates/{estimateId}/approvePUT/api/v2/estimates/{estimateId}PUT/api/v2/estimates/{estimateId}/pipelineGET/api/v2/estimates/{estimateId}/attachmentsGET/api/v2/estimatesGET/api/v2/estimates/{estimateId}GET/api/v2/estimates/{estimateId}/attachments/{attachmentId}GET/api/v2/estimates/{estimateId}/pdfDELETE/api/v2/estimates/{estimateId}

Proformas

Proforma invoice management

12 endpoints
POST/api/v2/proformasPOST/api/v2/proformas/{proformaId}/approvePOST/api/v2/proformas/{proformaId}/attachmentsPOST/api/v2/proformas/{proformaId}/sendPUT/api/v2/proformas/{proformaId}PUT/api/v2/proformas/{proformaId}/pipelineGET/api/v2/proformas/{proformaId}/attachmentsGET/api/v2/proformasGET/api/v2/proformas/{proformaId}GET/api/v2/proformas/{proformaId}/attachments/{attachmentId}GET/api/v2/proformas/{proformaId}/pdfDELETE/api/v2/proformas/{proformaId}

Credit Notes

Credit note management

13 endpoints
POST/api/v2/credit-notesPOST/api/v2/credit-notes/{creditNoteId}/paymentsPOST/api/v2/credit-notes/{creditNoteId}/approvePOST/api/v2/credit-notes/{creditNoteId}/attachmentsPOST/api/v2/credit-notes/{creditNoteId}/sendPUT/api/v2/credit-notes/{creditNoteId}PUT/api/v2/credit-notes/{creditNoteId}/pipelineGET/api/v2/credit-notes/{creditNoteId}/attachmentsGET/api/v2/credit-notesGET/api/v2/credit-notes/{creditNoteId}GET/api/v2/credit-notes/{creditNoteId}/attachments/{attachmentId}GET/api/v2/credit-notes/{creditNoteId}/pdfDELETE/api/v2/credit-notes/{creditNoteId}

Services

Service catalog management

5 endpoints
POST/api/v2/servicesPUT/api/v2/services/{serviceId}GET/api/v2/servicesGET/api/v2/services/{serviceId}DELETE/api/v2/services/{serviceId}

Sales Channels

Sales channel management

5 endpoints
POST/api/v2/sales-channelsPUT/api/v2/sales-channels/{salesChannelId}GET/api/v2/sales-channelsGET/api/v2/sales-channels/{salesChannelId}DELETE/api/v2/sales-channels/{salesChannelId}

Numbering Series

Document numbering series configuration

4 endpoints
POST/api/v2/numbering-series/{type}PUT/api/v2/numbering-series/{type}/{numberingSeriesId}GET/api/v2/numbering-series/{type}DELETE/api/v2/numbering-series/{type}/{numberingSeriesId}

Contacts

Contact

Contact management (clients, suppliers, leads)

12 endpoints
POST/api/v2/contactsPOST/api/v2/contacts/{contactId}/attachmentsPUT/api/v2/contacts/{contactId}GET/api/v2/contacts/{contactId}/attachmentsGET/api/v2/contactsGET/api/v2/contacts/{contactId}GET/api/v2/contacts/{contactId}/attachments/{filename}GET/api/v2/contacts/{contactId}/portal-linkDELETE/api/v2/contacts/{contactId}POST/api/v2/contacts/bulk-archivePOST/api/v2/contacts/bulk-deleteGET/api/v2/contacts/search

Contact Group

Contact group management

5 endpoints
POST/api/v2/contact-groupsPUT/api/v2/contact-groups/{contactGroupId}GET/api/v2/contact-groupsGET/api/v2/contact-groups/{contactGroupId}DELETE/api/v2/contact-groups/{contactGroupId}

Tags

Tag management

3 endpoints
POST/api/v2/tagsGET/api/v2/tagsDELETE/api/v2/tags/{tag}

Accounting

Accounting

Chart of accounts and ledger entries

6 endpoints
POST/api/v2/accounting-accountsPOST/api/v2/ledger-entriesGET/api/v2/accounting-accountsGET/api/v2/ledger-entriesGET/api/v2/ledger-entries/{ledgerEntryId}DELETE/api/v2/ledger-entries/{ledgerEntryId}

Expenses Accounts

Expense account management

5 endpoints
POST/api/v2/expenses-accountsPUT/api/v2/expenses-accounts/{expensesAccountId}GET/api/v2/expenses-accountsGET/api/v2/expenses-accounts/{expensesAccountId}DELETE/api/v2/expenses-accounts/{expensesAccountId}

Payment

Payment management (create, update, delete, list)

5 endpoints
POST/api/v2/paymentsPUT/api/v2/payments/{paymentId}GET/api/v2/paymentsGET/api/v2/payments/{paymentId}DELETE/api/v2/payments/{paymentId}

Purchases

Purchase invoice management

14 endpoints
POST/api/v2/purchasesPOST/api/v2/purchases/{purchaseId}/paymentsPOST/api/v2/purchases/{purchaseId}/approvePOST/api/v2/purchases/{purchaseId}/attachmentsPOST/api/v2/purchases/refundPUT/api/v2/purchases/{purchaseId}PUT/api/v2/purchases/{purchaseId}/pipelineGET/api/v2/purchases/{purchaseId}/attachmentsGET/api/v2/purchasesGET/api/v2/purchases/{purchaseId}GET/api/v2/purchases/{purchaseId}/attachments/{attachmentId}GET/api/v2/purchases/refund/{purchaseRefundId}GET/api/v2/purchase-refundsDELETE/api/v2/purchases/{purchaseId}

Tax

Tax configuration and compliance management

2 endpoints
GET/api/v2/taxesGET/api/v2/taxes/keys-by-country

Treasury

Banking accounts

Banking account management within the Treasury product

10 endpoints
POST/api/v2/treasury/accounts/{id}/archivePOST/api/v2/treasury/accounts/{bankingAccountId}/bank-movementsGET/api/v2/treasury/accountsPOST/api/v2/treasury/accountsGET/api/v2/treasury/accounts/{id}PUT/api/v2/treasury/accounts/{id}DELETE/api/v2/treasury/accounts/{id}GET/api/v2/treasury/accounts/{id}/bank-movementsGET/api/v2/treasury/accounts/{id}/cash-movementsPOST/api/v2/treasury/accounts/{bankingAccountId}/bank-movements/{movementId}/reconcile

Payment Methods

Payment method configuration and management

5 endpoints
POST/api/v2/payment-methodsPUT/api/v2/payment-methods/{paymentMethodId}DELETE/api/v2/payment-methods/{paymentMethodId}GET/api/v2/payment-methodsGET/api/v2/payment-methods/{paymentMethodId}

Remittances

Remittance management within the Treasury product

2 endpoints
GET/api/v2/treasury/remittancesGET/api/v2/treasury/remittances/{remittanceId}

Invoicing Forecast

Invoicing forecast management for cashflow planning linked to estimates and purchase orders

5 endpoints
POST/api/v2/treasury/cashflow/invoicing-forecastsPUT/api/v2/treasury/cashflow/invoicing-forecasts/{forecastId}GET/api/v2/treasury/cashflow/invoicing-forecastsGET/api/v2/treasury/cashflow/invoicing-forecasts/{forecastId}DELETE/api/v2/treasury/cashflow/invoicing-forecasts/{forecastId}

Business Plan

Business Plan goals — targets vs. actuals by accounting account and month

2 endpoints
GET/api/v2/business-plan/goalsGET/api/v2/business-plan/scenarios

CRM

Funnels

CRM funnel and pipeline stage management

5 endpoints
POST/api/v2/funnelsPUT/api/v2/funnels/{funnelId}GET/api/v2/funnelsGET/api/v2/funnels/{funnelId}DELETE/api/v2/funnels/{funnelId}

Leads

CRM lead tracking and lifecycle management

12 endpoints
POST/api/v2/leadsPOST/api/v2/leads/{leadId}/notesPOST/api/v2/leads/{leadId}/tasksPUT/api/v2/leads/{leadId}/notesPUT/api/v2/leads/{leadId}/tasksPUT/api/v2/leads/{leadId}PUT/api/v2/leads/{leadId}/datesPUT/api/v2/leads/{leadId}/stageGET/api/v2/leadsGET/api/v2/leads/{leadId}DELETE/api/v2/leads/{leadId}/tasksDELETE/api/v2/leads/{leadId}

Projects

Projects

Project management

6 endpoints
POST/api/v2/projectsPUT/api/v2/projects/{projectId}GET/api/v2/projects/{projectId}GET/api/v2/projects/{projectId}/summaryGET/api/v2/projectsDELETE/api/v2/projects/{projectId}

Tasks

Task management within projects

5 endpoints
POST/api/v2/tasksPUT/api/v2/tasks/{taskId}GET/api/v2/tasksGET/api/v2/tasks/{taskId}DELETE/api/v2/tasks/{taskId}

Project Time Tracking

Time tracking entries for projects

6 endpoints
POST/api/v2/projects/{projectId}/timesPUT/api/v2/projects/{projectId}/times/{timeId}GET/api/v2/projects/{projectId}/timesGET/api/v2/project-timesGET/api/v2/projects/{projectId}/times/{timeId}DELETE/api/v2/projects/{projectId}/times/{timeId}

Inventory

Products

Product management

12 endpoints
POST/api/v2/productsPOST/api/v2/products/{productId}/imagesPUT/api/v2/products/{productId}PUT/api/v2/products/{productId}/stockGET/api/v2/productsGET/api/v2/products/{productId}/imagesGET/api/v2/products/{productId}GET/api/v2/products/{productId}/images/{imageId}GET/api/v2/products/{productId}/imageGET/api/v2/products/{productId}/stockGET/api/v2/products/{productId}/stock/transitDELETE/api/v2/products/{productId}

Price Lists

Product price list management

5 endpoints
POST/api/v2/price-listsPATCH/api/v2/price-lists/{priceListId}GET/api/v2/price-listsGET/api/v2/price-lists/{priceListId}DELETE/api/v2/price-lists/{priceListId}

Warehouses

Warehouse and stock management

6 endpoints
POST/api/v2/warehousesPATCH/api/v2/warehouses/{warehouseId}GET/api/v2/warehousesGET/api/v2/warehouses/{warehouseId}GET/api/v2/warehouses/{warehouseId}/stockDELETE/api/v2/warehouses/{warehouseId}

Sales Orders

Sales order management

16 endpoints
POST/api/v2/sales-ordersPOST/api/v2/sales-orders/{salesOrderId}/approvePOST/api/v2/sales-orders/{salesOrderId}/attachmentsPOST/api/v2/sales-orders/{salesOrderId}/sendPOST/api/v2/sales-orders/{salesOrderId}/shipPOST/api/v2/sales-orders/{salesOrderId}/ship-by-linesPUT/api/v2/sales-orders/{salesOrderId}PUT/api/v2/sales-orders/{salesOrderId}/pipelinePUT/api/v2/sales-orders/{salesOrderId}/trackingGET/api/v2/sales-orders/{salesOrderId}/attachmentsGET/api/v2/sales-ordersGET/api/v2/sales-orders/{salesOrderId}GET/api/v2/sales-orders/{salesOrderId}/attachments/{attachmentId}GET/api/v2/sales-orders/{salesOrderId}/pdfGET/api/v2/sales-orders/{salesOrderId}/shipped-itemsDELETE/api/v2/sales-orders/{salesOrderId}

Waybills

Waybill and shipment management

13 endpoints
POST/api/v2/waybillsPOST/api/v2/waybills/{waybillId}/approvePOST/api/v2/waybills/{waybillId}/attachmentsPOST/api/v2/waybills/{waybillId}/sendPUT/api/v2/waybills/{waybillId}PUT/api/v2/waybills/{waybillId}/pipelinePUT/api/v2/waybills/{waybillId}/trackingGET/api/v2/waybills/{waybillId}/attachmentsGET/api/v2/waybillsGET/api/v2/waybills/{waybillId}GET/api/v2/waybills/{waybillId}/attachments/{attachmentId}GET/api/v2/waybills/{waybillId}/pdfDELETE/api/v2/waybills/{waybillId}

Purchase Orders

Purchase order management

14 endpoints
POST/api/v2/purchase-ordersPOST/api/v2/purchase-orders/{purchaseOrderId}/approvePOST/api/v2/purchase-orders/{purchaseOrderId}/attachmentsPOST/api/v2/purchase-orders/{purchaseOrderId}/receivePOST/api/v2/purchase-orders/{purchaseOrderId}/sendPUT/api/v2/purchase-orders/{purchaseOrderId}PUT/api/v2/purchase-orders/{purchaseOrderId}/pipelineGET/api/v2/purchase-orders/{purchaseOrderId}/attachmentsGET/api/v2/purchase-ordersGET/api/v2/purchase-orders/{purchaseOrderId}GET/api/v2/purchase-orders/{purchaseOrderId}/attachments/{attachmentId}GET/api/v2/purchase-orders/{purchaseOrderId}/pdfGET/api/v2/purchase-orders/{purchaseOrderId}/received-itemsDELETE/api/v2/purchase-orders/{purchaseOrderId}

Purchase Shipments

Purchase shipment and receiving management

6 endpoints
POST/api/v2/purchase-shipmentsPOST/api/v2/purchase-shipments/{purchaseShipmentId}/approvePUT/api/v2/purchase-shipments/{purchaseShipmentId}GET/api/v2/purchase-shipmentsGET/api/v2/purchase-shipments/{purchaseShipmentId}DELETE/api/v2/purchase-shipments/{purchaseShipmentId}

Documents

Cross-document operations (e.g. convert between document types)

1 endpoints
POST/api/v2/documents/convert

Production Orders

Production order and manufacturing pipeline management

5 endpoints
POST/api/v2/production-ordersPUT/api/v2/production-orders/{productionOrderId}GET/api/v2/production-ordersGET/api/v2/production-orders/{productionOrderId}DELETE/api/v2/production-orders/{productionOrderId}

Team & HR

Employees

Employee CRUD management

7 endpoints
POST/api/v2/employeesPUT/api/v2/employees/{employeeId}PUT/api/v2/employees/{employeeId}/contractGET/api/v2/employeesGET/api/v2/employees/{employeeId}GET/api/v2/employees/{employeeId}/contractDELETE/api/v2/employees/{employeeId}

Employee Time Tracking

Employee time tracking, clock-in/out and pause management

10 endpoints
POST/api/v2/employees/{employeeId}/clock-inPOST/api/v2/employees/{employeeId}/clock-outPOST/api/v2/employees/{employeeId}/timesPOST/api/v2/employees/{employeeId}/pausePOST/api/v2/employees/{employeeId}/unpausePUT/api/v2/employee-times/{timeId}GET/api/v2/employees/{employeeId}/timesGET/api/v2/employee-timesGET/api/v2/employee-times/{timeId}DELETE/api/v2/employee-times/{timeId}

Salary records

Salary record management (non-payslip payroll documents)

7 endpoints
POST/api/v2/salary-recordsPUT/api/v2/salary-records/{salaryRecordId}GET/api/v2/salary-recordsGET/api/v2/salary-records/{salaryRecordId}GET/api/v2/salary-records/form-dataGET/api/v2/salary-records/{salaryRecordId}/pdfDELETE/api/v2/salary-records/{salaryRecordId}

Payslips

Payslip (nómina) management — calculated payroll documents, not salary records

8 endpoints
POST/api/v2/payslips/{payslipId}/approvePOST/api/v2/payslipsPOST/api/v2/payslips/{payslipId}/paymentsGET/api/v2/payslipsGET/api/v2/payslips/{payslipId}GET/api/v2/payslips/{payslipId}/pdfDELETE/api/v2/payslips/{payslipId}DELETE/api/v2/payslips/{payslipId}/payments/{paymentId}

Time off

Employee time off, absence, holiday, vacation and leave request management

5 endpoints
POST/api/v2/employees/{employeeId}/time-offsPUT/api/v2/employees/{employeeId}/time-offs/{timeOffId}GET/api/v2/employees/{employeeId}/time-offsGET/api/v2/employees/{employeeId}/time-offs/{timeOffId}GET/api/v2/employees/time-offs

Calendar

Events

Calendar events management

5 endpoints
POST/api/v2/eventsPUT/api/v2/events/{eventId}GET/api/v2/eventsGET/api/v2/events/{eventId}DELETE/api/v2/events/{eventId}

Bookings

Booking and reservation management

7 endpoints
POST/api/v2/bookingsPUT/api/v2/bookings/{bookingId}GET/api/v2/bookingsGET/api/v2/booking-locationsGET/api/v2/bookings/{bookingId}GET/api/v2/booking-locations/{locationId}/slotsDELETE/api/v2/bookings/{bookingId}

Inbox

Inbox

Incoming document management (OCR, scan and verify)

9 endpoints
POST/api/v2/inboxPOST/api/v2/inbox/{incomingDocumentId}/attachPOST/api/v2/inbox/{incomingDocumentId}/exportPUT/api/v2/inbox/{incomingDocumentId}GET/api/v2/inboxGET/api/v2/inbox/{incomingDocumentId}GET/api/v2/inbox/{incomingDocumentId}/files/{filename}/downloadGET/api/v2/inbox/{incomingDocumentId}/files/{filename}/previewDELETE/api/v2/inbox/{incomingDocumentId}

Developers

Developers

Developer tools — API usage monitoring and token management

2 endpoints
GET/api/v2/usageGET/api/v2/usage/{type}

Webhooks

Webhook subscription management

8 endpoints
POST/api/v2/webhooksPOST/api/v2/webhooks/{webhookId}/disablePOST/api/v2/webhooks/{webhookId}/enablePUT/api/v2/webhooks/{webhookId}GET/api/v2/webhooksGET/api/v2/webhooks/{webhookId}GET/api/v2/webhooks/eventsDELETE/api/v2/webhooks/{webhookId}