LIlight
v1 - Tax codes

Get a tax code

Returns a single tax code by ID, whatever its status or company entity assignments.

get/v1/tax-codes/{id}

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

Path parameters

idstring uuid required

Response

default response

idstring uuid

Unique identifier for the tax code. Documents reference it as taxCodeId

companyIdstring uuid

ID of the company

codestring

Short code of the tax code, unique within the company

namestring

Display name of the tax code

ratenumber

Tax rate as a fraction: 0.25 is 25%. Null for an exempt tax code

type'PURCHASE' | 'SALES'

Whether the tax code applies to purchases (bills) or to sales (sales invoices)

⚠️ This enum is not exhaustive; new values may be added in the future.

status'ACTIVE' | 'DISABLED' | 'DISABLED_EXTERNALLY'

Status of the tax code. DISABLED_EXTERNALLY is set by an ERP sync when the code was disabled in the ERP

⚠️ This enum is not exhaustive; new values may be added in the future.

sourceType'INTERNAL' | 'SYNCED_EXTERNALLY'

Where the tax code is maintained. SYNCED_EXTERNALLY means the code mirrors one in the company's ERP; INTERNAL means it was created in Light

⚠️ This enum is not exhaustive; new values may be added in the future.

country'AC' | 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BU' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CP' | 'CR' | 'CS' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DG' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EA' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'EU' | 'EZ' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'FX' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'IC' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NT' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SF' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SU' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TA' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TP' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UK' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XI' | 'XU' | 'XK' | 'YE' | 'YT' | 'YU' | 'ZA' | 'ZM' | 'ZR' | 'ZW'

Country whose tax rules the tax code follows

⚠️ This enum is not exhaustive; new values may be added in the future.

taxCategory'GOODS' | 'SERVICES'

Whether the tax code is for goods or for services. Null when not set

⚠️ This enum is not exhaustive; new values may be added in the future.

edifactCode'AE' | 'E' | 'G' | 'K' | 'L' | 'M' | 'O' | 'S' | 'Z'

Duty or tax category code from the UNCL5305 code list, used on electronic invoices (https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/)

⚠️ This enum is not exhaustive; new values may be added in the future.

contextstring

Free-text guidance describing when the tax code applies

companyEntityIdsstring[]

Company entities the code may be used in

createdAtstring date-time

Timestamp when the tax code was created

updatedAtstring date-time

Timestamp when the tax code was last updated

Example response

{
  "rate": 0.25
}

Changes

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