---
title: "Get Featured Companies"
method: GET
path: "/v1/featured-companies"
tags: ["internal"]
---

# Get Featured Companies

`GET /v1/featured-companies`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/featured-companies`
- Auth: none declared

Get featured companies for the front page with three-tier fallback:

1. Premium (business_plus) companies - always first, guaranteed placement
2. Other claimed profiles (free/business) - fill remaining slots
3. Random active companies - fill any remaining slots

This ensures the list is always full, even at launch with few claimed profiles.
Premium companies are shuffled for fair rotation among paying customers.
Results are cached for 5 minutes.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- FeaturedCompaniesResponse: Featured companies response.
  - `companies` FeaturedCompany[], required
    - `cvr` string, required
    - `name` string, required
    - `logo_url` string, nullable
    - `description` string, nullable
    - `description_en` string, nullable
    - `website` string, nullable
    - `focus_rank` integer, nullable
    - `focus_total_dkk` integer, nullable
    - `social_links` object, nullable
    - `tier` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)