Skip to main content
GET
/
serving-permits
/
{id}
Get serving permit details by restaurant number
curl --request GET \
  --url https://lens-api.tic.io/serving-permits/{id} \
  --header 'x-api-key: <api-key>'
import requests

url = "https://lens-api.tic.io/serving-permits/{id}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://lens-api.tic.io/serving-permits/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://lens-api.tic.io/serving-permits/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://lens-api.tic.io/serving-permits/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://lens-api.tic.io/serving-permits/{id}")
  .header("x-api-key", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://lens-api.tic.io/serving-permits/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "restaurantNumber": "<string>",
  "municipality": "<string>",
  "county": "<string>",
  "mostRecentPermit": {
    "folkhalsomyndigheten_ServingPermitId": 123,
    "restaurantNumber": "<string>",
    "servingLocationName": "<string>",
    "servingAddress": "<string>",
    "servingPostalCode": "<string>",
    "formattedPostalCode": "<string>",
    "servingCity": "<string>",
    "servingCompanyRegistrationNumber": "<string>",
    "formattedServingCompanyRegistrationNumber": "<string>",
    "permitHolderName": "<string>",
    "categoryCode": 123,
    "category": {
      "code": 123,
      "permitType": "<string>",
      "beverageType": "<string>",
      "beverageType2": "<string>",
      "servingType": "<string>"
    },
    "municipality": "<string>",
    "validFrom": "2023-11-07T05:31:56Z",
    "probationaryPeriodTo": "2023-11-07T05:31:56Z",
    "validTo": "2023-11-07T05:31:56Z",
    "lineHash": "<string>",
    "folkhalsomyndigheten_FileId": 123,
    "companyId": 123,
    "isProcessed": true,
    "lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
    "geocodedLatitude": 123,
    "geocodedLongitude": 123,
    "geocodedAtUtc": "2023-11-07T05:31:56Z",
    "geocodeQueryScore": 123,
    "hasCoordinates": true,
    "company": {
      "companyId": 123,
      "companyRegistrationNumber": "<string>",
      "formattedCompanyRegistrationNumber": "<string>",
      "legalEntityType": "<string>",
      "registrationDate": "2023-11-07T05:31:56Z",
      "companyRegisterId": 123,
      "ceasedDate": "2023-11-07T05:31:56Z",
      "lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
      "foundAtUtc": "2023-11-07T05:31:56Z",
      "isCeased": true,
      "elfCode": "<string>",
      "formationDate": "2023-11-07T05:31:56Z",
      "localCompanyCode": "<string>",
      "companySummary": {
        "companyId": 123,
        "companySummaryId": 123,
        "legalName": "<string>",
        "purpose": "<string>",
        "sniCodes": "<string>",
        "sniCodes2025": "<string>",
        "sniCodesList": {},
        "sniCodes2025List": {},
        "visitingAddressStreet": "<string>",
        "visitingAddressPostalCode": "<string>",
        "visitingAddressCity": "<string>",
        "visitingAddressCountryCodeAlpha3": "<string>",
        "visitingAddressPosition": [
          123
        ],
        "isVistingAddressEmpty": true,
        "isVisitingAddressMissing": true,
        "visitingAddressPositionLatitude": 123,
        "visitingAddressPositionLongitude": 123,
        "mailingAddressStreet": "<string>",
        "mailingAddressPostalCode": "<string>",
        "mailingAddressCity": "<string>",
        "mailingAddressCountryCodeAlpha3": "<string>",
        "isMailingAddressEmpty": true,
        "isMailingAddressMissing": true,
        "mailingAddressPosition": [
          123
        ],
        "mailingAddressPositionLatitude": 123,
        "mailingAddressPositionLongitude": 123,
        "numberOfWorkplaces": 123,
        "registeredOfficeMunicipalityCode": "<string>",
        "registeredOfficeCountyCode": "<string>",
        "registeredVAT": true,
        "registeredFTax": true,
        "registeredPayroll": true,
        "scb_NumberOfEmployeesInterval": 123,
        "scb_NumberOfEmployeesIntervalDescription": "<string>",
        "scb_OwnershipType": 123,
        "scb_OwnershipTypeDescription": "<string>",
        "scb_TurnoverInterval": 123,
        "scb_TurnoverIntervalDescription": "<string>",
        "scb_PrivPublType": 123,
        "scb_PrivPublTypeDescription": "<string>",
        "scb_TradeExportInterval": 123,
        "scb_TradeExportIntervalDescription": "<string>",
        "scb_TradeImportInterval": 123,
        "scb_TradeImportIntervalDescription": "<string>",
        "scb_PropertyTaxationInterval": 123,
        "scb_PropertyTaxationIntervalDescription": "<string>",
        "period1": 123,
        "period1_IS_NetSalesK": 123,
        "period1_FN_NumberOfEmployees": 123,
        "period1_IS_OperatingProfitOrLossK": 123,
        "period1_IsAudited": true,
        "period1_Lines": [
          "<string>"
        ],
        "period2": 123,
        "period2_IS_NetSalesK": 123,
        "period2_FN_NumberOfEmployees": 123,
        "period2_IS_OperatingProfitOrLossK": 123,
        "period2_IsAudited": true,
        "period3": 123,
        "period3_IS_NetSalesK": 123,
        "period3_FN_NumberOfEmployees": 123,
        "period3_IS_OperatingProfitOrLossK": 123,
        "period3_IsAudited": true,
        "intelligenceScoreTotal": 123,
        "intelligenceNumberOfMax": 123,
        "numberOfEmailAddresses": 123,
        "lastCompanyActivityStatusDescription": "<string>",
        "lastCompanyStatusDescription2": {
          "name_EN": "<string>",
          "name_SE": "<string>",
          "bolagsverketCode": "<string>",
          "isCeased": true
        },
        "lastCompanyStatusDate": "2023-11-07T05:31:56Z",
        "lastCompanyStatusDescription": "<string>",
        "lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
        "hasAuditor": true,
        "companyRepresentativeBornYear": 123,
        "kfm_DebtBalanceTotalAmountInSEK": 123,
        "kfm_RecordOfNonPaymentNumberOfCases": 123,
        "registeredAML": true,
        "shouldBeRegisteredAML": true,
        "mailingAddressLantmaterietLocatedOnPropertyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "mailingAddressLantmaterietLocationalAddressId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "visitingAddressLantmaterietLocatedOnPropertyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "visitingAddressLantmaterietLocationalAddressId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "visitingAddressCO": "<string>",
        "mailingAddressCO": "<string>",
        "visitingAddressId": 123,
        "mailingAddressId": 123
      }
    }
  },
  "servingPermits": [
    {
      "folkhalsomyndigheten_ServingPermitId": 123,
      "restaurantNumber": "<string>",
      "servingLocationName": "<string>",
      "servingAddress": "<string>",
      "servingPostalCode": "<string>",
      "formattedPostalCode": "<string>",
      "servingCity": "<string>",
      "servingCompanyRegistrationNumber": "<string>",
      "formattedServingCompanyRegistrationNumber": "<string>",
      "permitHolderName": "<string>",
      "categoryCode": 123,
      "category": {
        "code": 123,
        "permitType": "<string>",
        "beverageType": "<string>",
        "beverageType2": "<string>",
        "servingType": "<string>"
      },
      "municipality": "<string>",
      "validFrom": "2023-11-07T05:31:56Z",
      "probationaryPeriodTo": "2023-11-07T05:31:56Z",
      "validTo": "2023-11-07T05:31:56Z",
      "lineHash": "<string>",
      "folkhalsomyndigheten_FileId": 123,
      "companyId": 123,
      "isProcessed": true,
      "lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
      "geocodedLatitude": 123,
      "geocodedLongitude": 123,
      "geocodedAtUtc": "2023-11-07T05:31:56Z",
      "geocodeQueryScore": 123,
      "hasCoordinates": true,
      "company": {
        "companyId": 123,
        "companyRegistrationNumber": "<string>",
        "formattedCompanyRegistrationNumber": "<string>",
        "legalEntityType": "<string>",
        "registrationDate": "2023-11-07T05:31:56Z",
        "companyRegisterId": 123,
        "ceasedDate": "2023-11-07T05:31:56Z",
        "lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
        "foundAtUtc": "2023-11-07T05:31:56Z",
        "isCeased": true,
        "elfCode": "<string>",
        "formationDate": "2023-11-07T05:31:56Z",
        "localCompanyCode": "<string>",
        "companySummary": {
          "companyId": 123,
          "companySummaryId": 123,
          "legalName": "<string>",
          "purpose": "<string>",
          "sniCodes": "<string>",
          "sniCodes2025": "<string>",
          "sniCodesList": {},
          "sniCodes2025List": {},
          "visitingAddressStreet": "<string>",
          "visitingAddressPostalCode": "<string>",
          "visitingAddressCity": "<string>",
          "visitingAddressCountryCodeAlpha3": "<string>",
          "visitingAddressPosition": [
            123
          ],
          "isVistingAddressEmpty": true,
          "isVisitingAddressMissing": true,
          "visitingAddressPositionLatitude": 123,
          "visitingAddressPositionLongitude": 123,
          "mailingAddressStreet": "<string>",
          "mailingAddressPostalCode": "<string>",
          "mailingAddressCity": "<string>",
          "mailingAddressCountryCodeAlpha3": "<string>",
          "isMailingAddressEmpty": true,
          "isMailingAddressMissing": true,
          "mailingAddressPosition": [
            123
          ],
          "mailingAddressPositionLatitude": 123,
          "mailingAddressPositionLongitude": 123,
          "numberOfWorkplaces": 123,
          "registeredOfficeMunicipalityCode": "<string>",
          "registeredOfficeCountyCode": "<string>",
          "registeredVAT": true,
          "registeredFTax": true,
          "registeredPayroll": true,
          "scb_NumberOfEmployeesInterval": 123,
          "scb_NumberOfEmployeesIntervalDescription": "<string>",
          "scb_OwnershipType": 123,
          "scb_OwnershipTypeDescription": "<string>",
          "scb_TurnoverInterval": 123,
          "scb_TurnoverIntervalDescription": "<string>",
          "scb_PrivPublType": 123,
          "scb_PrivPublTypeDescription": "<string>",
          "scb_TradeExportInterval": 123,
          "scb_TradeExportIntervalDescription": "<string>",
          "scb_TradeImportInterval": 123,
          "scb_TradeImportIntervalDescription": "<string>",
          "scb_PropertyTaxationInterval": 123,
          "scb_PropertyTaxationIntervalDescription": "<string>",
          "period1": 123,
          "period1_IS_NetSalesK": 123,
          "period1_FN_NumberOfEmployees": 123,
          "period1_IS_OperatingProfitOrLossK": 123,
          "period1_IsAudited": true,
          "period1_Lines": [
            "<string>"
          ],
          "period2": 123,
          "period2_IS_NetSalesK": 123,
          "period2_FN_NumberOfEmployees": 123,
          "period2_IS_OperatingProfitOrLossK": 123,
          "period2_IsAudited": true,
          "period3": 123,
          "period3_IS_NetSalesK": 123,
          "period3_FN_NumberOfEmployees": 123,
          "period3_IS_OperatingProfitOrLossK": 123,
          "period3_IsAudited": true,
          "intelligenceScoreTotal": 123,
          "intelligenceNumberOfMax": 123,
          "numberOfEmailAddresses": 123,
          "lastCompanyActivityStatusDescription": "<string>",
          "lastCompanyStatusDescription2": {
            "name_EN": "<string>",
            "name_SE": "<string>",
            "bolagsverketCode": "<string>",
            "isCeased": true
          },
          "lastCompanyStatusDate": "2023-11-07T05:31:56Z",
          "lastCompanyStatusDescription": "<string>",
          "lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
          "hasAuditor": true,
          "companyRepresentativeBornYear": 123,
          "kfm_DebtBalanceTotalAmountInSEK": 123,
          "kfm_RecordOfNonPaymentNumberOfCases": 123,
          "registeredAML": true,
          "shouldBeRegisteredAML": true,
          "mailingAddressLantmaterietLocatedOnPropertyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "mailingAddressLantmaterietLocationalAddressId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "visitingAddressLantmaterietLocatedOnPropertyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "visitingAddressLantmaterietLocationalAddressId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "visitingAddressCO": "<string>",
          "mailingAddressCO": "<string>",
          "visitingAddressId": 123,
          "mailingAddressId": 123
        }
      }
    }
  ]
}
Enterprise+ tier

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Restaurant number (restaurangnummer) assigned by the Swedish authorities

Response

Serving permit details

​
restaurantNumber
null | string
​
municipality
null | string
​
county
null | string
​
mostRecentPermit
object
​
servingPermits
null | object[]