Get demographics for a BRF

BRF add-on

GEThttps://lens-api.tic.io/brf/{companyId}/demographics

Total resident count, median age, and median förvärvsinkomst (when there are at least 20 adults; income is computed over residents aged 18 and over).
A breakdown by age band and gender. Cells with fewer than 5 residents are suppressed.
All figures cover the current residents folkbokförda at the BRF’s addresses.

Authorization

x-api-keystringheaderrequired

Your API key, sent in the x-api-key header.

Path parameters

companyIdintegerrequired

Internal company ID

format: int32

Responses

BRF demographics summary with age-bucket breakdown · application/json

companyIdinteger

format: int32

residentCountinteger

format: int32

medianAgeinteger | null

format: int32

medianForvarvsinkomstinteger | null

format: int64

lastUpdatedAtUtcstring

format: date-time

ageBucketsBrfDemographicsAge_Dto[] | null

Hide child attributes

ageBucketIdinteger

format: int32

ageBucketLabelstring | null

genderinteger

format: int32

residentCountinteger

format: int32

Authorization

Stored in this browser only (until you forget it) and sent as the x-api-key header through the documentation proxy.

Path

companyId *integer

Enter your API key to send.

Request

curl "https://lens-api.tic.io/brf/{companyId}/demographics" \
  -H "x-api-key: YOUR_API_KEY"

{
  "companyId": 123,
  "residentCount": 123,
  "medianAge": 123,
  "medianForvarvsinkomst": 123,
  "lastUpdatedAtUtc": "2026-01-15T10:30:00Z",
  "ageBuckets": [
    {
      "ageBucketId": 123,
      "ageBucketLabel": "<string>",
      "gender": 123,
      "residentCount": 123
    }
  ]
}