---
title: "Tenant-scoped setup facts and recent activity for the portal"
method: GET
path: "/v1/home"
tags: ["Usage"]
---

# Tenant-scoped setup facts and recent activity for the portal

`GET /v1/home`

## Request

- Base URL: `https://api.ironfang.com/rig`
- URL: `https://api.ironfang.com/rig/v1/home`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Counts of projects, suites and runs, the moments that mark setup (a key first reached the product, the first run started, the first run finished), and the seven most recent runs as activity. Labels carry no addresses, names or payloads. Needs rig.read.

## Response `200`

Counts, timestamps and at most seven activity labels

- object
  - `activity` object[], required
    - `at` string, date-time, required
    - `href` string, required
    - `id` string, uuid, required
    - `issue` 'error' | 'warning': Present when the run failed (error) or expired (warning).
    - `label` string, required
  - `counts` object, required
  - `first_value_at` string, date-time
  - `integrated_at` string, date-time
  - `key_at` string, date-time
  - `last_activity_at` string, date-time
  - `product` 'rig', required

## Other responses

- `401`: No credential, an invalid one, or a delegated token where none is accepted (`unauthorized`, `invalid_api_key`, `delegated_not_allowed`).
- `403`: The credential lacks the permission or scope, or names another organisation (`forbidden`, `insufficient_scope`).

---

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