ShopCreate Billing Detail

Create Billing Detail

Create a billing detail for the company given in the Company-Id header. The server sets company from that header. company_name and contact_name are required.

curl -X POST "https://api.getkini.com/billing_details/" \
  -H "Content-Type: application/json" \
  -H "Company-Id: 1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "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
}'
{
  "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"
}
POST
/billing_details/
POST
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>.
Content-Typestring
Required

The media type of the request body

Options: application/json
header
Company-Idinteger
Required

Kini ID of the company the key is associated with

company_namestring
Required

Legal name that appears on the invoice

contact_namestring
Required

Name of the person who receives the invoice

emailstring

Email address the invoice is sent to

Format: email
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

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

Body

application/json
company_namestring
Required

Legal name that appears on the invoice

Example:
Example Company GmbH
contact_namestring
Required

Name of the person who receives the invoice

Example:
Jane Doe
emailstring

Email address the invoice is sent to

Example:
billing@example.com
phonestring

Phone number of the billing contact

Example:
+493012345678
streetstring

Street and house number on the invoice

Example:
Example Street 1
citystring

City on the invoice

Example:
Berlin
countrystring

Country on the invoice

Example:
Germany
postcodestring

Postal code on the invoice

Example:
10115
branchstring

Branch or department this invoice belongs to

Example:
Berlin Office
cost_centerstring

Cost center printed on the invoice

Example:
CC-440
vat_numberstring

VAT identification number

Example:
DE123456789
tax_numberstring

National tax number

Example:
12/345/67890
is_defaultboolean

Whether this is the company's default billing detail

Example:
true

Responses