---
title: "Search activities"
method: GET
path: "/activities"
tags: ["Activities"]
---

# Search activities

`GET /activities`

## Request

- Base URL: `https://api.apino.sk/api/v1`
- URL: `https://api.apino.sk/api/v1/activities`
- Auth: HTTP bearer

Search for economic activities (business descriptions, NACE codes) across all organizations.
Results are grouped by organization — one record per org with optional nested activity details.

Useful for finding companies by what they do — e.g., "software development", "stavebné práce" (construction work).

## Query parameters

- `description` string
- `countries` string
- `code` string
- `current` boolean
- `active` boolean
- `details` boolean
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of organizations with activities

- ActivitySearchList
  - `data` ActivitySearchResult[]
    - `organization_ico` string: Organization CIN
    - `country_code` 'SK' | 'CZ': Country the organization belongs to.
    - `organization_name` string: Organization name
    - `main_activity_code` string, nullable: NACE main activity code (e.g. "62010")
    - `main_activity_description` string, nullable: Description of the NACE main activity code
    - `activities` ActivityDetail[], nullable: Nested activity details (only present when details=true)
      - `description` string: Description of the economic activity
      - `valid_from` string, date-time: Start date of the activity. A timestamp at midnight UTC (`2018-03-02T00:00:00Z`); only the date part carries meaning.
      - `valid_to` string, date-time: End date; absent while current. A timestamp at midnight UTC (`2018-03-02T00:00:00Z`); only the date part carries meaning.
      - `suspended_from` string, date-time: Suspension start date. A timestamp at midnight UTC (`2018-03-02T00:00:00Z`); only the date part carries meaning.
      - `suspended_to` string, date-time: Suspension end date. A timestamp at midnight UTC (`2018-03-02T00:00:00Z`); only the date part carries meaning.
      - `is_current` boolean: Whether the activity is currently active
  - `count` integer: Number of organizations in this page
  - `limit` integer: Limit used
  - `offset` integer: Offset used
  - `has_more` boolean: Whether more results exist beyond this page

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded

---

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