---
title: "New entries, newest first"
method: GET
path: "/v1/companies"
---

# New entries, newest first

`GET /v1/companies`

## Request

- Base URL: `https://swissnewco.tollwyn.com`
- URL: `https://swissnewco.tollwyn.com/v1/companies`
- Auth: HTTP bearer

## Query parameters

- `published_from` string, date
- `published_to` string, date
- `canton` string
- `zip` string
- `legal_form` string
- `has_website` boolean
- `has_email` boolean
- `has_care_of` boolean
- `is_branch` boolean
- `checks_min` integer
- `q` string
- `limit` integer
- `cursor` string

## Response `200`

A page of records

- object
  - `data` Company[]
    - `id` string, uuid
    - `uid` string
    - `name` string
    - `name_translations` string[]
    - `legal_form` object
      - `code` string
      - `name` string
      - `short` string
    - `is_branch` boolean
    - `head_office` object, nullable
      - `name` string
      - `uid` string, nullable
    - `seat` string
    - `canton` 'AG' | 'AI' | 'AR' | 'BE' | 'BL' | 'BS' | 'FR' | 'GE' | 'GL' | 'GR' | 'JU' | 'LU' | 'NE' | 'NW' | 'OW' | 'SG' | 'SH' | 'SO' | 'SZ' | 'TG' | 'TI' | 'UR' | 'VD' | 'VS' | 'ZG' | 'ZH'
    - `address` object
      - `care_of` string, nullable
      - `supplement` string, nullable
      - `street` string, nullable
      - `house_number` string, nullable
      - `po_box` string, nullable
      - `zip` string, nullable
      - `town` string, nullable
    - `purpose` string, nullable
    - `capital` object, nullable
      - `amount` number
      - `currency` string
    - `persons` object[]
      - `name` string, nullable
      - `family_name` string, nullable
      - `given_names` string, nullable
      - `residence` string, nullable
      - `role` string, nullable
      - `signature` string, nullable
    - `persons_parsed` boolean
    - `published_on` string, date
    - `registered_on` string, date, nullable
    - `language` string
    - `publication_text` string
    - `source` object
      - `publication_number` string
      - `url` string
    - `contact` object
      - `website` string, nullable
      - `website_verified_by` unknown
      - `email` string, nullable
      - `phone` string, nullable
      - `contact_page` string, nullable
      - `has_website` boolean
      - `has_email` boolean
      - `has_phone` boolean
      - `masked` boolean
      - `status` 'pending' | 'found' | 'not_found' | 'suppressed'
      - `checks` integer
      - `checked_at` string, date-time, nullable
  - `next_cursor` string, nullable

## Other responses

- `400`: An error
- `401`: An error
- `402`: An error
- `429`: An error

---

[API](https://skmtc.dev/tollwyn/apis/swiss-newco-feed-api.md) · [All operations](https://skmtc.dev/tollwyn/apis/swiss-newco-feed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tollwyn/apis/swiss-newco-feed-api/revisions/98f96727982d?raw)