Read a feed, enriched

GET

/v1/feeds/{group}/{id}

const url = 'http://localhost:3000/v1/feeds/example/example?limit=20';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'http://localhost:3000/v1/feeds/example/example?limit=20' \
  --header 'Authorization: Bearer <token>'

Authorizations

bearerAuth

Parameters

Path Parameters

group

required

string

required

string

Query Parameters

limit

integer

default: 20 >= 1 <= 100

~~cursor~~

deprecated

string

Deprecated alias for next. next wins if both are sent.

next

string

Opaque paging token. Pass the next value from the previous page.

Responses

200

A page of activities, reverse-chronological.

application/json

object

results

required

Array

next

required

Opaque cursor. Null when no further page.

string | null

results

required

Array<object>

object

required

string format: uuid

actor

required

string

verb

required

string

object

required

string

target

string | null

foreign_id

string | null

time

required

string format: date-time

custom

required

object

key

additional properties

any

origin_feed

required

string

reaction_counts

required

object

key

additional properties

integer

actor_user

Enriched from users.custom when actor parses as user:. Null otherwise.

object | null

own_reactions

Omitted for server tokens — no caller identity.

Array<string>

Example

{
  "results": [
    {
      "actor": "user:alice",
      "verb": "post",
      "object": "workout:123",
      "origin_feed": "user:alice",
      "reaction_counts": {
        "like": 3
      },
      "own_reactions": [
        "like"
      ]
    }
  ]
}

401

Invalid, expired, revoked, or absent token.

application/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED UNAUTHENTICATED FORBIDDEN NOT_FOUND CONFLICT RATE_LIMITED INTERNAL

message

required

string

requestId

required

string

fields

Present only for VALIDATION_FAILED.

Array<object>

object

path

string

message

string

Example

{
  "error": {
    "code": "VALIDATION_FAILED"
  }
}

429

Rate limit exceeded.

application/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED UNAUTHENTICATED FORBIDDEN NOT_FOUND CONFLICT RATE_LIMITED INTERNAL

message

required

string

requestId

required

string

fields

Present only for VALIDATION_FAILED.

Array<object>

object

path

string

message

string

Example

{
  "error": {
    "code": "VALIDATION_FAILED"
  }
}

Headers

Retry-After

integer