Billable Item

BillableItem

archived_at
string or null <date-time>
created_at
string <date-time>
id
string <int64>
item_code
string or null <= 100 characters
item_type
string
Enum: "Product" "Service" "Other"
object
name
string <= 255 characters
price
string <decimal> [ -4000000000 .. 4000000000 )
object
updated_at
string <date-time>
{}

List billable items

get/billable_items
SecuritybasicAuth
Request
query Parameters
order
string
Deprecated
Enum: "asc" "desc"
page
integer
per_page
integer [ 1 .. 100 ]
q[]
Array of strings

Filter result by one or more fields.

See Filtering Results

Available filters:

Value Format
archived_at date-time
created_at date-time
id int64
tax_id int64
updated_at date-time
sort
Array of strings

Comma separated search fields. See: Ordering

Example: sort=created_at:desc
Responses
200

successful operation

Request samples
Response samples
application/json
{}

Create billable item

post/billable_items
SecuritybasicAuth
Request
Request Body schema: application/json
item_code
string or null <= 100 characters
item_type
string
Enum: "Product" "Service" "Other"
name
string <= 255 characters
price
string <decimal> [ -4000000000 .. 4000000000 )
tax_id
string <int64>

tax id

Responses
201

Resource was created

422

Resource could not be saved due to validation errors

Request samples
application/json
{
  • "item_code": "string",
  • "item_type": "Product",
  • "name": "string",
  • "price": "string",
  • "tax_id": "1"
}
Response samples
application/json
{}

Get billable item

get/billable_items/{id}
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
query Parameters
q[]
Array of strings

Filter result by one or more fields.

See Filtering Results

Available filters:

Value Format
archived_at date-time
Responses
200

Successful operation

Request samples
Response samples
application/json
{}

Update billable item

patch/billable_items/{id}
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Request Body schema: application/json
item_code
string or null <= 100 characters
item_type
string
Enum: "Product" "Service" "Other"
name
string <= 255 characters
price
string <decimal> [ -4000000000 .. 4000000000 )
tax_id
string <int64>

tax id

Responses
200

Resource was updated

422

Resource could not be saved due to validation errors

Request samples
application/json
{
  • "item_code": "string",
  • "item_type": "Product",
  • "name": "string",
  • "price": "string",
  • "tax_id": "1"
}
Response samples
application/json
{}

Archive billable itemDeprecated

delete/billable_items/{id}
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Responses
204

Resource was archived successfully

Request samples

Archive billable item

post/billable_items/{id}/archive
SecuritybasicAuth
Request
path Parameters
id
required
string <int64>
Responses
204

Resource was archived

Request samples