> ## 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.

# Get a Dispute

> Retrieve a single dispute by its ID from the SOS database. This endpoint provides detailed information about a specific dispute including its status, involved parties, and related metadata.



## OpenAPI

````yaml https://api.storyapis.com/api/v4/openapi.json get /disputes/{disputeId}
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:
  /disputes/{disputeId}:
    get:
      tags:
        - Protocol V4
        - Disputes
      summary: Get a Dispute
      description: >-
        Retrieve a single dispute by its ID from the SOS database. This endpoint
        provides detailed information about a specific dispute including its
        status, involved parties, and related metadata.
      operationId: getDisputeV4
      parameters:
        - description: Dispute ID to retrieve
          example: '123'
          in: path
          name: disputeId
          required: true
          schema:
            description: Dispute ID to retrieve
            examples:
              - '123'
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDisputeResponseHumaBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    GetDisputeResponseHumaBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://api.storyapis.com/api/v4/GetDisputeResponseHumaBody.json
          format: uri
          readOnly: true
          type: string
        data:
          $ref: '#/components/schemas/Dispute'
          description: Dispute information
      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
    Dispute:
      additionalProperties: false
      properties:
        arbitrationPolicy:
          type: string
        blockNumber:
          type:
            - string
            - 'null'
        blockTimestamp:
          type: string
        counterEvidenceHash:
          type: string
        currentTag:
          type: string
        data:
          type: string
        deletedAt:
          type: string
        disputeTimestamp:
          type:
            - string
            - 'null'
        evidenceHash:
          type: string
        id:
          type:
            - string
            - 'null'
        initiator:
          type: string
        liveness:
          type:
            - string
            - 'null'
        logIndex:
          type: string
        status:
          type: string
        targetIpId:
          type: string
        targetTag:
          type: string
        transactionHash:
          type: string
        umaLink:
          type: string
      required:
        - id
        - targetIpId
        - targetTag
        - currentTag
        - arbitrationPolicy
        - evidenceHash
        - initiator
        - data
        - blockNumber
        - disputeTimestamp
        - transactionHash
        - status
        - counterEvidenceHash
        - liveness
      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

````