> For the complete documentation index, see [llms.txt](https://developer.dashdoc.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.dashdoc.com/docs/api-reference/invoice-items.md).

# Invoice items

## List Dashdoc invoice items

> List the authenticated company's Dashdoc invoice item catalogue.\
> Requires Dashdoc Invoicing enabled for the company and TMS read access.\
> \
> Enabled and disabled items are returned by default. Results are ordered by\
> description, ignoring case.<br>

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"InvoiceItems"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"DashdocInvoiceItems":{"properties":{"count":{"description":"Total number of items matching the filters.","minimum":0,"type":"integer"},"next":{"description":"URL of the next page, or null on the last page.","format":"uri","nullable":true,"type":"string"},"previous":{"description":"URL of the previous page, or null on the first page.","format":"uri","nullable":true,"type":"string"},"results":{"items":{"$ref":"#/components/schemas/DashdocInvoiceItem"},"type":"array"}},"required":["count","next","previous","results"],"type":"object"},"DashdocInvoiceItem":{"properties":{"uid":{"format":"uuid","type":"string"},"description":{"description":"Name of the invoice item in the catalogue.","type":"string"},"line_description":{"description":"Default description when this item is used on a price or invoice line.","type":"string"},"account_code":{"description":"Accounting code associated with the invoice item.","type":"string"},"enabled":{"description":"Whether this catalogue item is enabled.","type":"boolean"},"tax_code":{"$ref":"#/components/schemas/DashdocInvoiceItem_tax_code"}},"required":["account_code","description","enabled","line_description","tax_code","uid"],"type":"object"},"DashdocInvoiceItem_tax_code":{"properties":{"dashdoc_id":{"description":"Dashdoc identifier of the tax code.","type":"string"},"tax_rate":{"description":"Tax rate as a percentage, encoded as a decimal string.","format":"decimal","type":"string"},"tax_type":{"description":"Type of tax, resolved for the authenticated company's country.","enum":["IGIC","IRPF","RETENTION","TPS","TVH","TVQ","VAT"],"type":"string"}},"required":["dashdoc_id","tax_rate","tax_type"],"type":"object"}}},"paths":{"/dashdoc-invoice-items/":{"get":{"description":"List the authenticated company's Dashdoc invoice item catalogue.\nRequires Dashdoc Invoicing enabled for the company and TMS read access.\n\nEnabled and disabled items are returned by default. Results are ordered by\ndescription, ignoring case.\n","operationId":"listDashdocInvoiceItems","parameters":[{"description":"Filter by enabled status. Omit this parameter to include both enabled and disabled items.","in":"query","name":"enabled","required":false,"schema":{"type":"boolean"}},{"description":"Page number within the paginated result set.","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Number of items per page.","in":"query","name":"page_size","required":false,"schema":{"default":20,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashdocInvoiceItems"}}},"description":"Paginated Dashdoc invoice items."},"400":{"description":"Invalid or unknown query parameters."},"401":{"description":"Authentication required."},"403":{"description":"Access to this company's Dashdoc invoice item catalogue is not permitted."},"404":{"description":"The requested page is out of range."}},"summary":"List Dashdoc invoice items","tags":["InvoiceItems"]}}}}
````

## Beta: List third-party invoice items

> List invoice items from external invoicing connectors for companies that do not\
> use Dashdoc Invoicing. For the Dashdoc Invoicing catalogue, use\
> \`GET /dashdoc-invoice-items/\`.<br>

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"InvoiceItems"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"InvoiceItems":{"properties":{"count":{"type":"integer"},"next":{"nullable":true,"type":"string"},"previous":{"nullable":true,"type":"string"},"results":{"items":{"$ref":"#/components/schemas/InvoiceItem"},"type":"array"}},"type":"object"},"InvoiceItem":{"properties":{"uid":{"format":"uuid","type":"string"},"remote_id":{"description":"The id of the invoice item in your system","type":"string"},"description":{"description":"Default description when a user selects this invoice item for an invoice line","type":"string"}},"type":"object"}}},"paths":{"/invoices/items/":{"get":{"description":"List invoice items from external invoicing connectors for companies that do not\nuse Dashdoc Invoicing. For the Dashdoc Invoicing catalogue, use\n`GET /dashdoc-invoice-items/`.\n","operationId":"listInvoiceItems","parameters":[{"description":"A page number within the paginated result set.","in":"query","name":"page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceItems"}}},"description":"Get successful"}},"summary":"Beta: List third-party invoice items","tags":["InvoiceItems"]}}}}
````

## POST /invoices/items/

> Beta: Create an invoice item

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"InvoiceItems"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"NewInvoiceItem":{"properties":{"remote_id":{"description":"The id of the invoice item in your system","type":"string"},"description":{"description":"Default description when a user selects this invoice item for an invoice line","type":"string"}},"type":"object"},"InvoiceItem":{"properties":{"uid":{"format":"uuid","type":"string"},"remote_id":{"description":"The id of the invoice item in your system","type":"string"},"description":{"description":"Default description when a user selects this invoice item for an invoice line","type":"string"}},"type":"object"}}},"paths":{"/invoices/items/":{"post":{"operationId":"createInvoiceItem","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewInvoiceItem"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceItem"}}},"description":"Create successful"}},"summary":"Beta: Create an invoice item","tags":["InvoiceItems"]}}}}
````

## DELETE /invoices/items/{uid\_or\_remote\_id}/

> Delete an invoice intem

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"InvoiceItems"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}}},"paths":{"/invoices/items/{uid_or_remote_id}/":{"delete":{"operationId":"deleteInvoiceItem","parameters":[{"description":"Dashdoc `uid` or your `remote_id`. With a `remote_id`, you must add `lookup_field=remote_id` to the query parameters.","in":"path","name":"uid_or_remote_id","required":true,"schema":{"anyOf":[{"format":"uuid","title":"uid","type":"string"},{"title":"remote_id","type":"string"}]}},{"description":"Used to specify what field is used in the URL to identify the object you're requesting, e.g. with the `remote_id` (see path parameters)","in":"query","name":"lookup_field","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Empty body"}},"summary":"Delete an invoice intem","tags":["InvoiceItems"]}}}}
````

## PATCH /invoices/items/{uid\_or\_remote\_id}/

> Beta: Partially update an invoice item

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"InvoiceItems"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"UpdateInvoiceItem":{"properties":{"remote_id":{"description":"The id of the invoice item in your system","type":"string"},"description":{"description":"Default description when a user selects this invoice item for an invoice line","type":"string"}},"type":"object"},"InvoiceItem":{"properties":{"uid":{"format":"uuid","type":"string"},"remote_id":{"description":"The id of the invoice item in your system","type":"string"},"description":{"description":"Default description when a user selects this invoice item for an invoice line","type":"string"}},"type":"object"}}},"paths":{"/invoices/items/{uid_or_remote_id}/":{"patch":{"operationId":"partialUpdateInvoiceItem","parameters":[{"description":"Dashdoc `uid` or your `remote_id`. With a `remote_id`, you must add `lookup_field=remote_id` to the query parameters.","in":"path","name":"uid_or_remote_id","required":true,"schema":{"anyOf":[{"format":"uuid","title":"uid","type":"string"},{"title":"remote_id","type":"string"}]}},{"description":"Used to specify what field is used in the URL to identify the object you're requesting, e.g. with the `remote_id` (see path parameters)","in":"query","name":"lookup_field","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateInvoiceItem"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceItem"}}},"description":"Update successful"}},"summary":"Beta: Partially update an invoice item","tags":["InvoiceItems"]}}}}
````
