Skip to main content

Get a Line Item

GET 
/api/v8/partner/documents/:document_id/line-items/:line_item_id

Get a Line Item

Request​

Path Parameters

    document_id int64required

    The unique identifier of the document.

    line_item_id int64required

    The unique identifier of the line item.

Responses​

Document's Line Item

Schema
    id integerrequired

    The unique number created to identify the Line Item object.

    order integerrequired

    The value indicating the position of where the line item appears on the document.

    tags string[]

    Possible values: non-empty

    A user-defined list of identifiers that help to categorize or flag particular types of line items.

    text stringrequired

    Possible values: non-empty and <= 1000 characters

    The complete text returned for the line item, including prices, dates, etc.

    type stringrequired

    Possible values: [room, tax, parking, service, fee, delivery, product, food, alcohol, tobacco, transportation, fuel, refund, discount, payment, giftcard, donation, toll, lottery]

    The classification of the product. The line type predicted by Veryfi, e.g. food.

    product_info object

    Line item extra product info

    anyOf
    expanded_description stringrequired

    Possible values: non-empty

    brand stringrequired

    Possible values: non-empty

    category string[]required

    Possible values: non-empty

    date date

    The date found on the document and associated with the line item in ISO 8601 format.

    description stringrequired

    Possible values: non-empty and <= 1000 characters

    The product or service's extracted name or description excluding date and price.

    full_description string

    Possible values: non-empty and <= 1000 characters

    The item text including dates, weight, etc.

    normalized_description string

    Possible values: non-empty

    The line item description with expanded words

    discount_price number

    The lower price after discount.

    discount_rate number

    The discount percentage that was applied to the line item.

    discount number

    The amount deducted from the total price for the line item.

    price number

    The unit price for the line item.

    quantity number

    The amount or number of units for the line item. This value is computable.

    reference string

    Possible values: non-empty

    section string

    Possible values: non-empty

    A grouping indicated by formatted text on the receipt or invoice.

    sku string

    Possible values: non-empty

    The Stock Keeping Unit (SKU) is the unique code associated with the product for the line item.

    tax_rate number

    The percent at which the individual or corporation is taxed for the line item.

    tax number

    The amount at which the individual or corporation is taxed for the product on this line item.

    total number

    The total price for this line item. This value is computable.

    subtotal number

    Total charges and credits before tip and tax, if applicable. This value is computable.

    unit_of_measure string

    Possible values: non-empty

    The unit of measurement for this line item.

    category string

    Possible values: non-empty

    The category is taken from the line item with the same SKU and/or description. Otherwise from the root category field.

    country_of_origin string

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

    The country of manufacture, production, design, or brand origin where the product comes from.

    custom_fields object

    A user-defined dictionary that contains all the custom fields generated by applying specific rules and regular expressions to the extracted data.

    product_details object[]

    Product lookup details

  • Array [
    • avg_price numberrequired

    The average price of the product

    brand stringrequired

    Possible values: non-empty

    The brand name of the product

    ean stringrequired

    Possible values: non-empty

    European Article Number (EAN) of the product

    extra_fields objectrequired

    Additional fields for the product details

    property name* any

    Additional fields for the product details

    gtin_14 stringrequired

    Possible values: non-empty

    Global Trade Item Number (GTIN-14) of the product

    match_score numberrequired

    Possible values: <= 1

    The match score of the product

    image stringrequired

    Possible values: non-empty

    The image URL of the product

    image_url stringrequired

    Possible values: non-empty

    Alternative field for the image URL of the product

    product_name stringrequired

    Possible values: non-empty

    The name of the product

    segment stringrequired

    Possible values: non-empty

    The market segment of the product

    veryn stringrequired

    Possible values: non-empty

    The veryn identifier of the product

  • ]
    • end_date date

    A service end date identified for the line item in ISO 8601 format.

    gross_total number

    The line item total before deductions.

    hsn string

    Possible values: non-empty

    The Harmonized System Nomenclature (HSN) found for the line item.

    lot string

    Possible values: non-empty

    The batch or lot number for the line item.

    start_date date

    A service start date identified for the line item in ISO 8601 format.

    tax_code string

    Possible values: non-empty

    The classification of goods and services for tax purposes for the line item.

    manufacturer string

    Possible values: non-empty

    The name of the manufacturer of the product for the line item.

    net_total number

    The line item total after deductions.

    upc string

    Possible values: non-empty

    The Universal Product Code (UPC), European Article Number (EAN), or Global Trade Item Number (GTIN) found for the line item on this document will be placed in this field.

    weight string

    Possible values: non-empty

    The weight of the item for the line item. Usually found on logistic invoices.

Loading...