---
title: "List invoice customers"
method: GET
path: "/invoice-customers"
tags: ["Invoicing"]
---

# List invoice customers

`GET /invoice-customers`

Lists the invoicing counterparty register — the parties you invoice, with their e-invoice addresses and per-party defaults.

## Query parameters

- `customer_id` string

## Response `200`

Invoice customers.

- object
  - `customer_id` string
  - `customers` Party[]
    - `id` string — Party id. Include on upsert to update an existing party.
    - `name` string, required
    - `business_id` string — Finnish business ID (Y-tunnus), e.g. `1234567-8`.
    - `vat_number` string — EU VAT number, e.g. `FI12345678`.
    - `address_line1` string
    - `postal_code` string
    - `city` string
    - `country_code` string — ISO 3166-1 alpha-2, e.g. `FI`.
    - `email` string
    - `einvoice_address` string — E-invoice (verkkolasku) address, e.g. an OVT identifier.
    - `einvoice_operator` string — E-invoice operator/intermediator code.
    - `default_payment_terms_days` integer
    - `default_vat_code` string
    - `default_vat_rate_basis_points` integer — Default VAT rate in basis points (25.5% = 2550).
    - `default_invoice_language` string

## Other responses

- `401` — Missing or invalid bearer token.
- `403` — Insufficient scope or role — e.g. a read-scoped key on a mutating method, or an API key on an admin/approver-only endpoint.

---

[API](https://skmtc.net/lastaccountingcompany/apis/lac-customer-api.md) · [All operations](https://skmtc.net/lastaccountingcompany/apis/lac-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lastaccountingcompany/lac-customer-api/revisions/52e277b4f031/schema)