BizKitHub
DocsAPI ReferenceAddress/bff/address/detail
getAddressAdmin BFF

/bff/address/detail

Returns a single address record by its external ID.

AddressgetBffAddressDetail

Parameters

1 query

Query parameters

· 1
idstringRequired

External address identifier.

Exampleaddr_abc123

Response schema

1 status code documented

200SuccessAddress detail.
idstringRequired

Unique external address identifier.

Exampleaddr_abc123
typestringOptional

Address type: accounting, billing, deliveryGoods or deliveryInvoice.

Examplebilling
firstNamestringOptional

First name.

ExampleJan
lastNamestringOptional

Last name.

ExampleNovák
companyNamestringOptional

Company name.

ExampleAcme s.r.o.
companyRegistrationNumberstringOptional

Company registration number (IČO).

Example05103118
taxIdentificationNumberstringOptional

Tax identification number (DIČ).

ExampleCZ9609040727
streetAddressstringOptional

Street and house number.

ExampleVodičkova 36
citystringOptional

City name.

ExamplePraha
cityPartstringOptional

City part or district.

ExampleNové Město
stateRegionstringOptional

State or region.

ExampleStředočeský kraj
postalCodestringOptional

Postal / ZIP code.

Example11000
countrystringOptional

ISO 3166-1 alpha-2 country code.

ExampleCZ
noticestringOptional

Internal note about the address.

frozenAtstringOptional

ISO timestamp when this address was frozen into an immutable snapshot referenced by an order/invoice. When present, admin UI must hide the edit affordance and render a "Read-only snapshot" badge — the DB trigger rejects any mutation attempt anyway.

Response example

application/json
{
  "id": "addr_abc123",
  "type": "billing",
  "firstName": "Jan",
  "lastName": "Novák",
  "companyName": "Acme s.r.o.",
  "companyRegistrationNumber": "05103118",
  "taxIdentificationNumber": "CZ9609040727",
  "streetAddress": "Vodičkova 36",
  "city": "Praha",
  "cityPart": "Nové Město",
  "stateRegion": "Středočeský kraj",
  "postalCode": "11000",
  "country": "CZ",
  "notice": "example_notice",
  "frozenAt": "example_frozenAt"
}

Request example

GET /bff/address/detail

get
curl -X GET "https://api.bizkithub.com/bff/address/detail?id=addr_abc123" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key