Browsing the Payments

Retrieve payment records from the In Process protocol. Supports filtering by artist and collector addresses.

Endpoint

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

Parameters

Name	Type	Required	Default	Description
artist	string	No	—	Filter by artist address (payments for tokens created by this artist)
collector	string	No	—	Filter by collector address (payments where this address is the buyer)

If no parameters are provided, returns the latest payment records. If collector is provided, payments are filtered so the purchaser is the provided address. If artist is provided, filters where the token creator is the provided address.

Request Examples

cURL

curl -X GET "https://inprocess.fun/api/payments?artist=0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01&collector=0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A"

Response Format

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

{
  "status": "success",
  "payments": [
    {
      "id": "bceddfb3-28f2-49f3-8669-73a813a06b90",
      "token": {
        "id": "5fc69bea-1a8a-47f0-8652-8bf041c16a06",
        "address": "0x06a701Ae65582B92Af48cDff45a8B20DcA3714cA",
        "tokenId": "0",
        "uri": "ar://1wMmKuaz-VdxmruOQJuYS-3nfU3zlNKmPNpc79Ou-qM",
        "defaultAdmin": "0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01",
        "chainId": 8453,
        "createdAt": "2025-06-07T20:41:35+00:00",
        "hidden": false
      },
      "buyer": {
        "address": "0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01",
        "username": "digital_artist_1",
        "bio": "Digital artist exploring the intersection of technology and creativity",
        "instagram_username": "@digital_artist_1",
        "twitter_username": "@digital_artist_1",
        "telegram_username": "@digital_artist_1"
      },
      "amount": "0.1",
      "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "block": "12345678"
    },
    {
      "id": "1a2b3c4d-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
      "token": {
        "id": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
        "address": "0x317e6E49970b95DD1bF2E7877110f3278CB8f1EA",
        "tokenId": "1",
        "uri": "ar://T5bcXlR7waq_aexj0Sp7SXR5uvwg3qAlMuai9oh6w-U",
        "defaultAdmin": "0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A",
        "chainId": 8453,
        "createdAt": "2025-06-07T17:13:07+00:00",
        "hidden": false
      },
      "buyer": {
        "address": "0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A",
        "username": "crypto_collector",
        "bio": "Passionate collector of digital art and NFTs",
        "instagram_username": "@crypto_collector",
        "twitter_username": "@crypto_collector",
        "telegram_username": "@crypto_collector"
      },
      "amount": "0.05",
      "hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "block": "12345679"
    }
  ]
}

Response Properties

Response Object

Property	Type	Description
status	string	Status of the request ("success" or "error")
payments	array	List of payment records
payments[].id	string	UUID of the payment record
payments[].token	object	Full token object with all token details
payments[].token.id	string	UUID of the token
payments[].token.address	string	Contract address of the token
payments[].token.tokenId	string	Token ID
payments[].token.uri	string	Metadata URI
payments[].token.defaultAdmin	string	Admin address of the token
payments[].token.chainId	number	Chain ID where the token exists
payments[].token.createdAt	string	ISO timestamp when the token was created
payments[].token.hidden	boolean	Whether the token is hidden
payments[].buyer	object	Full artist object with all buyer details
payments[].buyer.address	string	Address of the buyer
payments[].buyer.username	string	Username of the buyer
payments[].buyer.bio	string	Bio of the buyer
payments[].buyer.instagram_username	string	Instagram handle of the buyer
payments[].buyer.twitter_username	string	Twitter handle of the buyer
payments[].buyer.telegram_username	string	Telegram handle of the buyer
payments[].amount	string	Numeric amount paid
payments[].hash	string	Transaction hash
payments[].block	string	Block number where the transaction occurred

Error Response

If an error occurs, the API returns:

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