Items

Beta: List all invoice items

get
Authorizations
Query parameters
pageintegerOptional

A page number within the paginated result set.

Responses
200
Get successful
application/json
get
GET /api/v4/invoices/items/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Accept: */*
200

Get successful

{
  "count": 1,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "uid": "687cddac-dbd2-11ea-9024-0242ac130006",
      "remote_id": "ITEM_123",
      "description": "Gas transportation"
    }
  ]
}

Beta: Create an invoice item

post
Authorizations
Body
remote_idstringOptional

The id of the invoice item in your system

Example: ITEM_123
descriptionstringOptional

Default description when a user selects this invoice item for an invoice line

Example: Gas transportation
Responses
201
Create successful
application/json
post
POST /api/v4/invoices/items/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "remote_id": "ITEM_123",
  "description": "Gas transportation"
}
201

Create successful

{
  "uid": "687cddac-dbd2-11ea-9024-0242ac130006",
  "remote_id": "ITEM_123",
  "description": "Gas transportation"
}

Delete an invoice intem

delete
Authorizations
Path parameters
uidstringRequired
remote_idstringOptional

If you choose to identify an object with its remote_id instead of its uid then

  • replace the uid value with the remote_id value in the URL

  • specify lookup_field=remote_id in the query parameters

Query parameters
lookup_fieldstringOptional

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)

Responses
204
Empty body
delete
DELETE /api/v4/invoices/items/{uid}/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Accept: */*
204

Empty body

No content

Beta: Partially update an invoice item

patch
Authorizations
Path parameters
uidstring · uuidRequired
remote_idstringOptional

If you choose to identify an object with its remote_id instead of its uid then

  • replace the uid value with the remote_id value in the URL

  • specify lookup_field=remote_id in the query parameters

Query parameters
lookup_fieldstringOptional

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)

Body
remote_idstringOptional

The id of the invoice item in your system

Example: ITEM_123
descriptionstringOptional

Default description when a user selects this invoice item for an invoice line

Example: Gas transportation
Responses
200
Update successful
application/json
patch
PATCH /api/v4/invoices/items/{uid}/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "remote_id": "ITEM_123",
  "description": "Gas transportation"
}
200

Update successful

{
  "uid": "687cddac-dbd2-11ea-9024-0242ac130006",
  "remote_id": "ITEM_123",
  "description": "Gas transportation"
}

Last updated

Was this helpful?