Browsing the Collections

Browse collections from the In Process protocol. This endpoint can retrieve collections from a specific artist or browse the in•process collective collections, depending on whether the artist parameter is provided. Supports pagination for efficient browsing.

Endpoint

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

Parameters

Name	Type	Required	Default	Description
artist	string	No	—	Filter by artist address (collections created by this artist). When provided, returns the artist's collections. When omitted, returns the in•process collective collections.
limit	number	No	100	Number of records per page (max: 100)
page	number	No	1	The page number to retrieve
chain_id	number	No	8453	Filter by chain ID (default: Base chain, 8453)

The artist parameter determines the behavior of the endpoint:

When artist is provided: Returns collections from the specific artist (only collections created by that artist address).
When artist is omitted: Returns collections from the in•process collective collections.

You can filter by chain using the chain_id parameter (default: 8453 for Base). Pagination is supported through the limit and page parameters.

Request Examples

Artist Collections (with artist)

cURL

curl -X GET "https://inprocess.world/api/collections?artist=0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01&limit=10&page=1&chain_id=8453"

in•process Collections (without artist)

cURL

curl -X GET "https://inprocess.world/api/collections?chain_id=8453&limit=10&page=1"

Response Format

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

{
  "status": "success",
  "collections": [
    {
      "address": "0x06a701Ae65582B92Af48cDff45a8B20DcA3714cA",
      "chainId": 8453,
      "name": "My Collection",
      "uri": "ar://1wMmKuaz-VdxmruOQJuYS-3nfU3zlNKmPNpc79Ou-qM",
      "default_admin": {
        "address": "0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A",
        "username": "artist name 1"
      },
      "payout_recipient": "0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A",
      "created_at": "2025-06-07T20:41:35+00:00",
      "updated_at": "2025-08-12T12:28:41+00:00"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total_pages": 1
  }
}

Response Properties

Response Object

Property	Type	Description
status	string	Status of the request ("success" or "error")
collections	array	List of collection records
collections[].address	string	Contract address of the collection
collections[].chainId	number	Chain ID where the collection exists
collections[].name	string	Collection name
collections[].uri	string	Metadata URI
collections[].default_admin	object	Original admin set at collection creation
collections[].default_admin.address	string	Address of the default admin
collections[].default_admin.username	string	Username of the default admin, if available
collections[].payout_recipient	string	Address to receive sale proceeds
collections[].created_at	string	ISO timestamp when the collection was created
collections[].updated_at	string	ISO timestamp when the collection was updated
pagination	object	Pagination metadata for the response
pagination.page	number	Current page number
pagination.limit	number	Number of collections 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..."
}

Common error scenarios:

500 Internal Server Error: An error occurred while processing the request