LIlight
v1 - Tax codes

List tax codes

Returns a cursor-paginated list of the company's tax codes, the ones documents reference as taxCodeId. Only active tax codes are returned unless the request filters on status. With a filter on id, a tax code assigned to a company entity only inactively is returned as well.

get/v1/tax-codes

Request

  • Base URL
    https://light.inc (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header Authorization
    • or HTTP bearer

Query parameters

sortstring

Sort string in the format field:direction. To provide multiple sort fields, separate them with commas.

Available directions: asc, desc.

Available fields: code, context, type, rate, country, status, createdAt.

Example:amount:desc,createdAt:asc
filterstring

Filter string in the format field:operator:value. To provide multiple filters, separate them with commas.

Available operators: eq, ne, in, not_in, gt, gte, lt, lte.

  • For in and not_in operators, provide multiple values separated by the pipe character (|).

Available fields: id, companyEntityId, code, sourceType, status, type, createdAt.

Example:state:in:IN_DRAFT|SCHEDULED|PAID,amount:gte:500,vendorId:ne:null
searchTermstring

Matches against the tax code's code or name

limitinteger

Maximum number of items to return. Default is 50, maximum is 200.

cursorstring

The cursor position to start returning results from. Omit it, or provide 0, for the initial request. For subsequent requests, use nextCursor from the previous response to navigate. Cursor values are opaque and should not be constructed manually. This endpoint paginates by cursor only and has no offset parameter.

Response

default response

hasMoreboolean

Boolean flag indicating if there are more records available

nextCursorstring nullable

Cursor for fetching the next page

prevCursorstring nullable

Cursor for fetching the previous page

Example response

{
  "records": [
    {
      "rate": 0.25
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.