> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inprocess.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Browsing Notifications

> Retrieve notification records from the In•Process protocol. Supports filtering by artist address and viewed status.

**This is a public endpoint and does not require authentication.**

Endpoint behavior:
- If no parameters are provided: Returns the latest notification records.
- If `artist` is provided: Filters notifications where the artist is the provided address.
- If `viewed` is provided: Filters notifications by their viewed status (true for viewed, false for unviewed).



## OpenAPI

````yaml GET /notifications
openapi: 3.1.0
info:
  title: In•Process API
  description: >-
    The In•Process API enables browsing and managing moments from timelines.
    Retrieve moments from a specific artist's timeline, browse the in•process
    collective timeline, or filter by collection. The API supports creating
    moments, managing collections, handling payments, and interacting with the
    In•Process protocol ecosystem.
  version: 1.0.0
servers:
  - url: https://api.inprocess.world/api
    description: Production server
security: []
paths:
  /notifications:
    get:
      summary: Browsing Notifications
      description: >-
        Retrieve notification records from the In•Process protocol. Supports
        filtering by artist address and viewed status.


        **This is a public endpoint and does not require authentication.**


        Endpoint behavior:

        - If no parameters are provided: Returns the latest notification
        records.

        - If `artist` is provided: Filters notifications where the artist is the
        provided address.

        - If `viewed` is provided: Filters notifications by their viewed status
        (true for viewed, false for unviewed).
      operationId: getNotifications
      parameters:
        - name: artist
          in: query
          description: Filter by artist address (notifications for this artist)
          required: false
          schema:
            type: string
        - name: viewed
          in: query
          description: Filter by viewed status (true for viewed, false for unviewed)
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationsResponse'
              example:
                status: success
                notifications:
                  - id: bceddfb3-28f2-49f3-8669-73a813a06b90
                    payment:
                      id: 5fc69bea-1a8a-47f0-8652-8bf041c16a06
                      amount: '1'
                      currency: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
                      transaction_hash: >-
                        0xda5f2c55cb20d77ac935ad132afc58c1bf0940927f9afc2991d87f2eaba1d2a6
                      transferred_at: '2026-02-14T11:46:25+00:00'
                      moment:
                        id: a1b2c3d4-e5f6-4890-9a0b-c1d2e3f4a5b6
                        token_id: '1'
                        uri: ar://1wMmKuaz-VdxmruOQJuYS-3nfU3zlNKmPNpc79Ou-qM
                        collection:
                          address: '0x06a701Ae65582B92Af48cDff45a8B20DcA3714cA'
                          chain_id: 8453
                          creator: '0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01'
                        fee_recipients:
                          - artist_address: '0x29b6674c1562e31EdFd9709D9576e8E5F1e68d01'
                            percent_allocation: 100
                      buyer:
                        address: '0x4b4324bcC6dB9380ABBbbD20B24A16C11FB5B38A'
                        username: crypto_collector
                    artist:
                      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'
                    viewed: false
                    created_at: '2025-06-07T20:41:35+00:00'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security: []
components:
  schemas:
    NotificationsResponse:
      type: object
      required:
        - status
        - notifications
      properties:
        status:
          type: string
          description: Status of the request
          enum:
            - success
            - error
        notifications:
          type: array
          description: List of notification records
          items:
            $ref: '#/components/schemas/Notification'
    Error:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
          description: Error status
        message:
          type: string
          description: Error message
        errors:
          type: array
          description: >-
            Optional array of field-level validation errors. Typically included
            in 400 Bad Request responses for validation errors.
          items:
            type: object
            required:
              - field
              - message
            properties:
              field:
                type: string
                description: The field name that failed validation
              message:
                type: string
                description: The validation error message for this field
    Notification:
      type: object
      required:
        - id
        - payment
        - artist
        - viewed
        - created_at
      properties:
        id:
          type: string
          format: uuid
          description: UUID of the notification record
        payment:
          $ref: '#/components/schemas/Payment'
        artist:
          $ref: '#/components/schemas/Artist'
        viewed:
          type: boolean
          description: Whether the notification has been viewed
        created_at:
          type: string
          format: date-time
          description: ISO timestamp when the notification was created
    Payment:
      type: object
      required:
        - id
        - moment
        - buyer
        - amount
        - currency
        - transaction_hash
        - transferred_at
      properties:
        id:
          type: string
          format: uuid
          description: UUID of the payment record
        moment:
          $ref: '#/components/schemas/PaymentMoment'
        buyer:
          $ref: '#/components/schemas/PaymentBuyer'
        amount:
          type: string
          description: Numeric amount paid
        currency:
          type: string
          description: Currency contract address (e.g., USDC contract address)
        transaction_hash:
          type: string
          description: Transaction hash
        transferred_at:
          type: string
          format: date-time
          description: ISO timestamp when the payment was transferred
    Artist:
      type: object
      required:
        - address
        - username
        - bio
        - instagram_username
        - twitter_username
        - telegram_username
      properties:
        address:
          type: string
          description: Artist address
        username:
          type: string
          description: Artist username
        bio:
          type: string
          description: Artist bio
        instagram_username:
          type: string
          description: Instagram handle
        twitter_username:
          type: string
          description: Twitter handle
        telegram_username:
          type: string
          description: Telegram handle
    PaymentMoment:
      type: object
      required:
        - id
        - token_id
        - uri
        - collection
        - fee_recipients
      properties:
        id:
          type: string
          format: uuid
          description: UUID of the moment
        token_id:
          type: string
          description: Token ID
        uri:
          type: string
          description: Metadata URI
        collection:
          type: object
          required:
            - address
            - chain_id
            - creator
          properties:
            address:
              type: string
              description: Contract address of the collection
            chain_id:
              type: integer
              description: Chain ID where the collection exists
            creator:
              type: string
              description: Creator's address
        metadata:
          type: object
          description: Moment metadata object
          nullable: true
          properties:
            name:
              type: string
              description: Moment name
            image:
              type: string
              description: Image URI
            description:
              type: string
              description: Moment description
            content:
              type: object
              description: Content object with media information
              properties:
                mime:
                  type: string
                  description: MIME type of the content
                uri:
                  type: string
                  description: URI of the content
        fee_recipients:
          type: array
          description: Fee recipients for this moment
          items:
            type: object
            required:
              - artist_address
              - percent_allocation
            properties:
              artist_address:
                type: string
                description: Recipient artist address
              percent_allocation:
                type: number
                description: Allocation percentage (0-100)
    PaymentBuyer:
      type: object
      required:
        - address
        - username
      properties:
        address:
          type: string
          description: Address of the buyer
        username:
          type: string
          description: Username of the buyer
          nullable: true

````