ShopList Billing Details

List Billing Details

List the company's active billing details. Inactive records are left out, and the response is a JSON array. Keep the id, and send it as company_billing_detail when you create a booking. The product is invoiced to this record.

curl -X GET "https://api.getkini.com/billing_details/" \
  -H "Content-Type: application/json" \
  -H "Company-Id: 1" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
[
  {
    "id": 12,
    "company": 1,
    "company_name": "Example Company GmbH",
    "contact_name": "Jane Doe",
    "email": "billing@example.com",
    "phone": "+493012345678",
    "street": "Example Street 1",
    "city": "Berlin",
    "country": "Germany",
    "postcode": "10115",
    "branch": "Berlin Office",
    "cost_center": "CC-440",
    "vat_number": "DE123456789",
    "tax_number": "12/345/67890",
    "is_default": true,
    "created_at": "2026-07-21T06:03:12.447201Z",
    "updated_at": "2026-07-21T06:03:12.447201Z"
  }
]
GET
/billing_details/
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Authenticate every request with an API key from the Kini Partner App, sent as Authorization: Bearer <your_api_key>.

Authenticate every request with an API key from the Kini Partner App, sent as Authorization: Bearer <your_api_key>.
header
Company-Idinteger
Required

Kini ID of the company the key is associated with

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Authenticate every request with an API key from the Kini Partner App, sent as Authorization: Bearer <your_api_key>.

Headers

Company-Idinteger
Required

Kini ID of the company the key is associated with

Example:
1

Responses

idinteger

Kini ID of the billing detail

companyinteger

Kini ID of the company. Taken from the Company-Id header.

company_namestring

Legal name that appears on the invoice

contact_namestring

Name of the person who receives the invoice

emailstring

Email address the invoice is sent to

phonestring

Phone number of the billing contact

streetstring

Street and house number on the invoice

citystring

City on the invoice

countrystring

Country on the invoice

postcodestring

Postal code on the invoice

branchstring

Branch or department this invoice belongs to

cost_centerstring

Cost center printed on the invoice

vat_numberstring

VAT identification number

tax_numberstring

National tax number

is_defaultboolean

Whether this is the company's default billing detail

created_atstring

Timestamp of when the billing detail was created

updated_atstring

Timestamp of when the billing detail was last updated