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

# List IP Asset Edges

> Retrieve a list of edges (derivative registered events) that represent relationships between IP assets. These edges show parent-child relationships formed through licensing.



## OpenAPI

````yaml https://api.storyapis.com/api/v4/openapi.json post /assets/edges
openapi: 3.1.0
info:
  description: Story Protocol API V4
  title: Story Protocol API V4
  version: v4
servers:
  - url: https://api.storyapis.com/api/v4
  - url: https://staging-api.storyprotocol.net/api/v4
  - description: Local development server
    url: http://localhost:8080/api/v4
security: []
paths:
  /assets/edges:
    post:
      tags:
        - Protocol V4
        - IP Assets
      summary: List IP Asset Edges
      description: >-
        Retrieve a list of edges (derivative registered events) that represent
        relationships between IP assets. These edges show parent-child
        relationships formed through licensing.
      operationId: listEdgesV4
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EdgesRequestBodyHuma'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EdgesResponseHumaBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    EdgesRequestBodyHuma:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://api.storyapis.com/api/v4/EdgesRequestBodyHuma.json
          format: uri
          readOnly: true
          type: string
        orderBy:
          description: Field to order results by (currently only blockNumber is supported)
          enum:
            - blockNumber
          type: string
        orderDirection:
          default: desc
          description: Order direction for results
          enum:
            - asc
            - desc
          type: string
        pagination:
          $ref: '#/components/schemas/PaginationOptionsHuma'
          description: Pagination configuration
        where:
          $ref: '#/components/schemas/EdgesWhereOptionsHuma'
          description: Filter options for edges
      type: object
    EdgesResponseHumaBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://api.storyapis.com/api/v4/EdgesResponseHumaBody.json
          format: uri
          readOnly: true
          type: string
        data:
          description: List of derivative registered events (edges)
          items:
            $ref: '#/components/schemas/DerivativeRegisteredEvent'
          type:
            - array
            - 'null'
        pagination:
          $ref: '#/components/schemas/PaginationMetadataHuma'
          description: Pagination metadata
      required:
        - data
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://api.storyapis.com/api/v4/ErrorModel.json
          format: uri
          readOnly: true
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    PaginationOptionsHuma:
      additionalProperties: false
      properties:
        limit:
          default: 20
          description: Number of items to return
          examples:
            - 20
          format: int64
          maximum: 200
          minimum: 1
          type: integer
        offset:
          default: 0
          description: Number of items to skip
          examples:
            - 0
          format: int64
          minimum: 0
          type: integer
      type: object
    EdgesWhereOptionsHuma:
      additionalProperties: false
      properties:
        blockNumber:
          description: Block number to filter by
          format: int64
          minimum: 0
          type: integer
        childIpId:
          description: Child IP ID to filter by
          pattern: ^0x[a-fA-F0-9]{40}$
          type: string
        parentIpId:
          description: Parent IP ID to filter by
          pattern: ^0x[a-fA-F0-9]{40}$
          type: string
        txHash:
          description: Transaction hash to filter by
          pattern: ^0x[a-fA-F0-9]{64}$
          type: string
      type: object
    DerivativeRegisteredEvent:
      additionalProperties: false
      properties:
        blockNumber:
          format: int64
          type: integer
        blockTimestamp:
          format: date-time
          type: string
        caller:
          type: string
        childIpId:
          type: string
        id:
          format: int64
          type: integer
        licenseTemplate:
          type: string
        licenseTermsId:
          type: string
        licenseTokenId:
          type: string
        logIndex:
          format: int64
          type: integer
        parentIpId:
          type: string
        processedAt:
          format: date-time
          type: string
        txHash:
          type: string
      required:
        - id
        - blockNumber
        - blockTimestamp
        - txHash
        - logIndex
        - caller
        - childIpId
        - licenseTokenId
        - parentIpId
        - licenseTermsId
        - licenseTemplate
        - processedAt
      type: object
    PaginationMetadataHuma:
      additionalProperties: false
      properties:
        hasMore:
          description: Whether there are more items
          type: boolean
        limit:
          description: Current limit
          format: int64
          type: integer
        offset:
          description: Current offset
          format: int64
          type: integer
        total:
          description: Total count of items
          format: int64
          type: integer
      required:
        - offset
        - limit
        - total
        - hasMore
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: X-Api-Key
      type: apiKey

````