Browsing the Timeline

Retrieve moments from the collective timeline. Supports pagination for efficient browsing.

Note: You can add a moment to the collective timeline by creating a moment.

Endpoint

GET https://inprocess.fun/api/timeline

Parameters

Name	Type	Required	Default	Description
limit	number	No	100	Number of records per page (max: 100)
page	number	No	1	The page number to retrieve
latest	boolean	No	true	Sort by most recent first
artist	string	No	—	Filter by admin address (only moments administered by this artist address)
chainId	number	No	8453	Filter by chain ID (default: Base chain, 8453)
hidden	boolean	No	false	If true, includes moments marked as hidden by the admin (default: false)

You can filter the timeline to only show moments administered by a specific artist by providing the artist address as a query parameter. You can also filter by chain using the chainId parameter (default: 8453 for Base). To include moments that have been marked as hidden by the admin, set the hidden parameter to true (defaults to false).

Request Examples

cURL

curl -X GET "https://inprocess.fun/api/timeline?artist=0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01&chainId=8453&limit=2&page=1&latest=true&hidden=true"

Response Format

The API returns JSON responses. Here's an example success response:

{
  "status": "success",
  "moments": [
    {
      "address": "0x06a701Ae65582B92Af48cDff45a8B20DcA3714cA",
      "tokenId": "0",
      "chainId": 8453,
      "id": "bceddfb3-28f2-49f3-8669-73a813a06b90",
      "uri": "ar://1wMmKuaz-VdxmruOQJuYS-3nfU3zlNKmPNpc79Ou-qM",
      "admin": "0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01",
      "createdAt": "2025-06-07T20:41:35+00:00",
      "username": "artist name",
      "hidden": false
    },
    {
      "address": "0x317e6E49970b95DD1bF2E7877110f3278CB8f1EA",
      "tokenId": "0",
      "chainId": 8453,
      "id": "5fc69bea-1a8a-47f0-8652-8bf041c16a06",
      "uri": "ar://T5bcXlR7waq_aexj0Sp7SXR5uvwg3qAlMuai9oh6w-U",
      "admin": "0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A",
      "createdAt": "2025-06-07T17:13:07+00:00",
      "username": "artist name",
      "hidden": false
    }
  ],
  "pagination": {
    "total_count": 2,
    "page": 1,
    "limit": 2,
    "total_pages": 1
  }
}

Response Properties

Response Object

Property	Type	Description
status	string	Status of the request ("success" or "error")
moments	array	List of moments in the timeline
moments[].address	string	Moment contract address
moments[].tokenId	string	Moment ID
moments[].chainId	number	Chain ID
moments[].id	string	UUID of the moment
moments[].uri	string	Metadata URI
moments[].admin	string	Admin address
moments[].createdAt	string	ISO timestamp when the moment was created
moments[].username	string	Username of the admin/artist, if available
moments[].hidden	boolean	Whether the moment is hidden (admin only)
pagination	object	Pagination metadata for the response
pagination.total_count	number	Total number of moments available
pagination.page	number	Current page number
pagination.limit	number	Number of moments per page
pagination.total_pages	number	Total number of pages available

Error Response

If an error occurs, the API returns:

{
  "status": "error",
  "message": "...error message..."
}