# The Invoice object ### The Invoice object ```json { "id": "in_1MtHbELkdIwHu7ixl4OzzPMv", "object": "invoice", "account_country": "US", "account_name": "Stripe Docs", "account_tax_ids": null, "amount_due": 0, "amount_paid": 0, "amount_overpaid": 0, "amount_remaining": 0, "amount_shipping": 0, "application": null, "attempt_count": 0, "attempted": false, "auto_advance": false, "automatic_tax": { "enabled": false, "liability": null, "status": null }, "billing_reason": "manual", "collection_method": "charge_automatically", "created": 1680644467, "currency": "usd", "custom_fields": null, "customer": "cus_NeZwdNtLEOXuvB", "customer_address": null, "customer_email": "jennyrosen@example.com", "customer_name": "Jenny Rosen", "customer_phone": null, "customer_shipping": null, "customer_tax_exempt": "none", "customer_tax_ids": [], "confirmation_secret": null, "default_payment_method": null, "default_source": null, "default_tax_rates": [], "description": null, "discounts": [], "due_date": null, "ending_balance": null, "footer": null, "from_invoice": null, "hosted_invoice_url": null, "invoice_pdf": null, "issuer": { "type": "self" }, "last_finalization_error": null, "latest_revision": null, "lines": { "object": "list", "data": [], "has_more": false, "total_count": 0, "url": "/v1/invoices/in_1MtHbELkdIwHu7ixl4OzzPMv/lines" }, "payments": { "object": "list", "data": [], "has_more": false, "total_count": 0, "url": "/v1/invoice_payments" }, "livemode": false, "metadata": {}, "next_payment_attempt": null, "number": null, "on_behalf_of": null, "parent": null, "payment_settings": { "default_mandate": null, "payment_method_options": null, "payment_method_types": null }, "period_end": 1680644467, "period_start": 1680644467, "post_payment_credit_notes_amount": 0, "pre_payment_credit_notes_amount": 0, "receipt_number": null, "shipping_cost": null, "shipping_details": null, "starting_balance": 0, "statement_descriptor": null, "status": "draft", "status_transitions": { "finalized_at": null, "marked_uncollectible_at": null, "paid_at": null, "voided_at": null }, "subtotal": 0, "subtotal_excluding_tax": 0, "test_clock": null, "total": 0, "total_discount_amounts": [], "total_excluding_tax": 0, "total_taxes": [], "transfer_data": null, "webhooks_delivered_at": 1680644467 } ``` - `customer_tax_ids` (array of objects, nullable) The customer’s tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as `customer.tax_ids`. Once the invoice is finalized, this field will no longer be updated. - `customer_tax_ids.type` (enum) The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `au_acn`, `nz_bn`, `pt_nif`, `cz_dic`, `fr_siret`, `fr_siren`, `fr_spi`, `sm_coe`, `tt_vat`, `tt_bir`, `mu_vat`, `mz_nuit`, `au_wpn`, `md_cf`, `is_kt`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, `ic_nif`, `gh_tin`, `bw_vat`, `ci_vat`, or `unknown` Possible enum values: - `ad_nrt` - `ae_trn` - `al_tin` - `am_tin` - `ao_tin` - `ar_cuit` - `au_abn` - `au_acn` - `au_arn` - `au_wpn` - `aw_tin` - `az_tin` - `ba_tin` - `bb_tin` - `bd_bin` - `bf_ifu` - `bg_uic` - `bh_vat` - `bj_ifu` - `bo_tin` - `br_cnpj` - `br_cpf` - `bs_tin` - `bw_vat` - `by_tin` - `ca_bn` - `ca_gst_hst` - `ca_pst_bc` - `ca_pst_mb` - `ca_pst_sk` - `ca_qst` - `cd_nif` - `ch_uid` - `ch_vat` - `ci_vat` - `cl_tin` - `cm_niu` - `cn_tin` - `co_nit` - `cr_tin` - `cv_nif` - `cz_dic` - `de_stn` - `do_rcn` - `ec_ruc` - `eg_tin` - `es_cif` - `et_tin` - `eu_oss_vat` - `eu_vat` - `fo_vat` - `fr_siren` - `fr_siret` - `fr_spi` - `gb_vat` - `ge_vat` - `gh_tin` - `gi_tin` - `gn_nif` - `hk_br` - `hr_oib` - `hu_tin` - `ic_nif` - `id_npwp` - `il_vat` - `in_gst` - `is_kt` - `is_vat` - `it_cf` - `jp_cn` - `jp_rn` - `jp_trn` - `ke_pin` - `kg_tin` - `kh_tin` - `kr_brn` - `kz_bin` - `la_tin` - `li_uid` - `li_vat` - `lk_vat` - `ma_vat` - `md_cf` - `md_vat` - `me_pib` - `mk_vat` - `mr_nif` - `mu_vat` - `mx_rfc` - `my_frp` - `my_itn` - `my_sst` - `mz_nuit` - `ng_tin` - `no_vat` - `no_voec` - `np_pan` - `nz_bn` - `nz_gst` - `om_vat` - `pe_ruc` - `ph_tin` - `pl_nip` - `pt_nif` - `py_ruc` - `ro_tin` - `rs_pib` - `ru_inn` - `ru_kpp` - `sa_vat` - `sg_gst` - `sg_uen` - `si_tin` - `sm_coe` - `sn_ninea` - `sr_fin` - `sv_nit` - `th_vat` - `tj_tin` - `tr_tin` - `tt_bir` - `tt_vat` - `tw_vat` - `tz_vat` - `ua_vat` - `ug_tin` - `unknown` - `us_ein` - `uy_ruc` - `uz_tin` - `uz_vat` - `ve_rif` - `vn_tin` - `za_vat` - `zm_tin` - `zw_tin` - `customer_tax_ids.value` (string, nullable) The value of the tax ID.