# Activity

Schemas

An account's public activity: pushes, pull requests, issues, comments, reviews, releases, stars and forks, with the repository, branch or tag, issue or pull request number and title, and when.

## Endpoints

1 endpoint returns activity on GitHub.

- [GETGitHub Activity API`/v1/github/activity`](https://socialtap.dev/docs/reference/github/activity/index.md)

## Schema

Every endpoint above returns an array of these objects as `data`, with a [`page`](https://socialtap.dev/docs/pagination/index.md) object. The standard [`meta`](https://socialtap.dev/docs/reference/index.md#meta) comes with every response.

| Field | Type | Description |
| --- | --- | --- |
| `platform` | `string` | Platform ID (github, …). |
| `id` | `string` | The activity's ID: the platform's own event ID, else one derived from the repository, the kind and the month the platform groups it in (torvalds/linux:push:2026-05), stable across fetches. |
| `type` | `string` | What the account did: push (commits to a branch or tag), create and delete (a repository, branch or tag: ref_type), fork, star, watch (subscribed to a repository's notifications), issue and pull_request (opened, closed, merged…: action), review (of a pull request), comment (on an issue, pull request or commit), release, member (added to or left a repository or group), wiki (edited its pages), discussion; other: the platform's own kind in platform_type. New values may be added; treat any other value as other.<br>One of `push`, `create`, `delete`, `fork`, `star`, `watch`, `issue`, `pull_request`, `review`, `comment`, `release`, `member`, `wiki`, `discussion`, `other` |
| `platform_type` | `string` or `null` | The platform's own name for the kind (PushEvent on GitHub, "pushed to" on GitLab, commit_repo on Codeberg); null when the source shows none. |
| `action` | `string` or `null` | What happened to the target, for kinds with more than one action: opened, closed, reopened, merged, edited, created, deleted, published (a release), approved, changes_requested, commented, dismissed (a review), ready_for_review, added and removed (a member), joined and left, assigned, unassigned, labeled, unlabeled, review_requested, synchronized (new commits on a pull request). Null for a kind that is its own action (push, star, fork) or when not shown. New values may be added; treat any other value as null.<br>One of `opened`, `closed`, `reopened`, `merged`, `edited`, `created`, `deleted`, `published`, `approved`, `changes_requested`, `commented`, `dismissed`, `ready_for_review`, `added`, `removed`, `joined`, `left`, `assigned`, `unassigned`, `labeled`, `unlabeled`, `review_requested`, `synchronized` |
| `created_at` | `string` (date-time) | When it happened, RFC 3339 UTC, never later than the fetch. A date-only value is listed in approximate_fields; an item grouping a period's commits (GitHub's contribution timeline) is dated by the period's last day, or the day of the fetch while the period runs. |
| `actor` | `object` | The account that acted; fields null when not shown. |
| `actor.id` | `string` or `null` | Platform-native account ID; null when only the handle is known. |
| `actor.username` | `string` or `null` | Handle without the @; null when the account has none. |
| `actor.display_name` | `string` or `null` | Display name shown on the profile. |
| `actor.url` | `string` (uri) or `null` | Canonical profile URL. |
| `actor.avatar_url` | `string` (uri) or `null` | Profile picture URL. Platform CDN URLs can expire within hours. |
| `actor.is_verified` | `boolean` or `null` | Platform verification badge; null where the platform has no badge. |
| `repository` | `object` or `null` | The repository it happened in (for a fork, the one forked; for a create of a repository, the new one); null when it happened in none (joining a group). |
| `repository.id` | `string` or `null` | Platform-native repository ID (string); null when the source names it by path only. |
| `repository.full_name` | `string` or `null` | The repository's path, owner and name (torvalds/linux; nested groups on GitLab: group/subgroup/name); null when the source gives its ID only. |
| `repository.url` | `string` (uri) or `null` | The repository's page (https://github.com/torvalds/linux); null when unknown. |
| `ref` | `string` or `null` | The branch or tag pushed to, created or deleted, by its short name (main, v1.2.0; never refs/heads/…); null for other kinds and a created repository. |
| `ref_type` | `string` or `null` | What ref names, or what was created or deleted: branch, tag, or repository (a create or delete of the repository itself, with ref null); null for other kinds. New values may be added; treat any other value as null.<br>One of `branch`, `tag`, `repository` |
| `head_sha` | `string` or `null` | For a push, or a create of a branch or tag by a push, the commit the branch or tag points to after it (a full hexadecimal commit hash); null for other kinds or when not shown. |
| `target` | `object` or `null` | What the action was on, beyond the repository: the issue, pull request, release, discussion, wiki page or commit, the fork created, the member added; null for a push, a star and a create or delete of a ref. |
| `target.type` | `string` | The kind of thing acted on: issue, pull_request (a GitLab merge request), release, discussion, wiki_page, commit (a commit comment), repository (the fork created), profile (the member added); other: a platform's own kind. New values may be added; treat any other value as other.<br>One of `issue`, `pull_request`, `release`, `discussion`, `wiki_page`, `commit`, `repository`, `profile`, `other` |
| `target.id` | `string` or `null` | The target's platform-native ID (a commit's hash); null when not shown. |
| `target.number` | `integer` or `null` | An issue's, pull request's or discussion's number in its repository (#1089); null for other targets. |
| `target.title` | `string` or `null` | The target's title as the platform shows it (an issue's or pull request's title, a release's name, the fork's path, the member's username); null when the source does not carry it (GitHub's events omit a pull request's title). |
| `target.url` | `string` (uri) or `null` | The target's page; null when unknown. |
| `text` | `string` or `null` | What the account wrote in this action: a comment's or a review's body, as plain text or Markdown as the platform holds it; null for kinds with no text of their own or an empty review. |
| `url` | `string` (uri) or `null` | The page that shows what was done: the comment, the issue or pull request, the release, the pushed commits, the fork, else the repository; null when there is none. |
| `metrics` | `object` | Counts of this action; null = not shown, 0 = zero. |
| `metrics.commit_count` | `integer` or `null` | For a push, or a create of a branch or tag by a push, the commits it added (for a period's group, the commits in the period); null for other kinds or when the platform does not say. |
| `platform_specific` | `object` | Fields only this platform has, under its ID (platform_specific.\<platform>); each null when unknown. |
| `platform_specific.github` | `object` or `null` | GitHub's own fields. |
| `platform_specific.github.period_start_at` | `string` (date-time) or `null` | For an item that groups the commits an account made to one repository in a month (GitHub's contribution timeline), the month's first day, RFC 3339 UTC; created_at is then the month's last day, or the day of the fetch for the month still running. Null for a single action. |
| `platform_specific.github.repository_language` | `string` or `null` | For a created repository on the contribution timeline, its main language as GitHub shows it (JavaScript); null for other items and on the event feed. |
| `approximate_fields` | `string[]` | JSON paths of values the platform gives only by day or month (created_at on GitHub's contribution timeline). \[\] when all exact. |
| `unknown_fields` | `string[]` | JSON paths of lists whose \[\] means unknown rather than none; null already means unknown for every other field. \[\] when every list is known. |

## Item errors

Besides the [request-level errors](https://socialtap.dev/docs/errors/index.md) every endpoint can return, activity endpoints return:

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `not_found` | 404 | No | The item does not exist or was deleted. On GET /v1/requests/{id}/response: the response was not kept (details.reason says why). | Check the link or ID. Do not retry. |
| `private_or_unavailable` | 403 | No | The item exists but is not public: it is private, age- or region-restricted, or needs a login to view. It shares 403 with forbidden (which is about the key), so branch on the code. | Only public items can be fetched. Do not retry. |

---

[HTML version](https://socialtap.dev/resources/activity/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
