---
title: "List companies accessed by the user"
method: GET
path: "/api/v2/consumption/companies"
tags: ["Consumption"]
---

# List companies accessed by the user

`GET /api/v2/consumption/companies`

Return the companies the authenticated user has previously pulled data from.

**Behavior**
- Returns one entry per company the user has accessed.
- Results are ordered by `company_id` ascending.

**Response**
- A paginated list of accessed companies.
- Each record exposes `company_id`, `company_name` and `ticker` of the company, plus `first_accessed_at` (the first time the user accessed it).

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

- PaginatedAccessedCompanyList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` AccessedCompany[], required
    - `company_id` integer, required — Identifier of the company the user has accessed
    - `company_name` string, nullable, required — Name of the company
    - `ticker` string, nullable, required — Ticker symbol of the company
    - `first_accessed_at` string, date-time, required — Timestamp of the first time the user accessed the company

## Other responses

- `401`
- `403`
- `429`

---

[API](https://skmtc.net/daloopa/apis/daloopa-api.md) · [All operations](https://skmtc.net/daloopa/apis/daloopa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/daloopa/daloopa-api/versions/746538a1eb45/schema)