Timeline

Browse moments from timelines. This endpoint can retrieve moments from a specific artist's timeline or browse the in•process collective timeline, depending on whether the artist parameter is provided. Supports pagination for efficient browsing.

Endpoint

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

Parameters

The endpoint behavior depends on which parameters are provided:

• When collection is provided: Returns all moments (tokens) of the specified collection address.
• When artist is provided: Returns moments from the specific artist's timeline (only moments administered by that artist address). The type parameter can be used to filter by admin relationship.
• When both artist and collection are omitted: Returns moments from the in•process collective timeline (moments that are being created, indexed).

You can filter by chain using the chain_id 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

Artist Timeline (with artist)

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

Collection Timeline (with collection)

curl -X GET "https://inprocess.world/api/timeline?collection=0x06a701Ae65582B92Af48cDff45a8B20DcA3714cA&chain_id=8453&limit=2&page=1&hidden=true"

in•process Timeline (without artist or collection)

curl -X GET "https://inprocess.world/api/timeline?chain_id=8453&limit=2&page=1&hidden=true"

Response Format

The API returns JSON responses with the same structure. Here's an example success response:

{
  "status": "success",
  "moments": [
    {
      "address": "0x06a701Ae65582B92Af48cDff45a8B20DcA3714cA",
      "token_id": "1",
      "max_supply": 17256554458,
      "chain_id": 8453,
      "id": "bceddfb3-28f2-49f3-8669-73a813a06b90",
      "uri": "ar://1wMmKuaz-VdxmruOQJuYS-3nfU3zlNKmPNpc79Ou-qM",
      "default_admin": {
        "address": "0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A",
        "username": "artist name 1",
        "hidden": false
      },
      "admins": [
        {
          "address": "0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A",
          "username": "artist name 1",
          "hidden": false
        },
        {
          "address": "0xAF1452d289E22FbD0DEA9d5097353c72a90FAC33",
          "username": "artist name 2",
          "hidden": true
        }
      ],
      "created_at": "2025-06-07T20:41:35+00:00",
      "updated_at": "2025-08-12T12:28:41+00:00"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total_pages": 2
  }
}

Understanding default_admin and admins[]

• default_admin: Always present. Shows the original admin address that was set at collection creation. This field preserves the historical record of who originally created/administered the moment.

• admins[]: Contains the list of currently active admins, which can change over time as admin permissions are added or removed.

• Relationship: The default_admin will appear in the admins[] array if and only if they still have active admin permissions. If the original default admin no longer has admin permissions, they will not appear in admins[], but their information will still be available in the default_admin field.

Response Properties

Response Object

Error Response

If an error occurs, the API returns:

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