---
title: "Activity time series"
method: GET
path: "/api/v1/company/{slug}/activity"
tags: ["Companies"]
---

# Activity time series

`GET /api/v1/company/{slug}/activity`

## Request

- Base URL: `https://openmercantil.es`
- URL: `https://openmercantil.es/api/v1/company/{slug}/activity`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/company/:slug/activity/get.ts> (a function with typed inputs; its response is checked against the schema)

Return monthly registry activity count for the company over the last N months. Useful for sparklines.

## Path parameters

- `slug` string, required

## Headers

- `If-None-Match` string

## Response `200`

Time series

- CompanyActivityResponse
  - `slug` string, required
  - `count` integer, required
  - `series` object[], required
    - `period` string
    - `count` integer

## Other responses

- `304`: The admitted activity projection has not changed.
- `404`: Resource not found
- `429`: Rate limit exceeded
- `503`: Source policy, subject classification or activity projection unavailable

## Changes

- **2026-07-26** `996f96a11758`: 11 info
  - api operation id `getCompanyBySlugActivity` was added
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
  - added the new optional `header` request parameter `If-None-Match`
  - …7 more

[Operation history](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/changes/api/v1/company/:slug/activity/get.md)

---

[API](https://skmtc.dev/openmercantil/apis/openmercantil-public-api.md) - [All operations](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/revisions/601ff6123c86?raw)