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

# List active cases for the signed-in user

> Returns the user's active cases with simple pagination via a cursor.



## OpenAPI

````yaml /api-reference/api.yaml post /cases/list
openapi: 3.0.3
info:
  title: api
  description: >-
    The API service is the secure public gateway to our platform, letting people
    access features without touching our private internal APIs. It authenticates
    clients with its own internal tokens and then routes their requests to the
    right internal services behind the scenes.
  version: 1.0.0
servers:
  - url: https://api.platform.arb.inc
security: []
tags:
  - name: cases
  - name: docket
  - name: evidence
  - name: filings
  - name: organization
  - name: participants
  - name: schemas
  - name: service-of-notice
paths:
  /cases/list:
    post:
      tags:
        - cases
      summary: List active cases for the signed-in user
      description: Returns the user's active cases with simple pagination via a cursor.
      operationId: listCases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                cursor:
                  type: string
                  format: date-time
                  nullable: true
                  description: Return cases created after this timestamp.
                  example: '2025-07-15T10:20:30Z'
            examples:
              default:
                summary: Start from a timestamp
                value:
                  cursor: '2025-07-15T10:20:30Z'
      responses:
        '200':
          description: Cases successfully listed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  cases:
                    type: array
                    description: List of active cases for the user.
                    items:
                      type: object
                      properties:
                        overview:
                          type: object
                          description: Summary information about the case.
                          properties:
                            id:
                              type: string
                              description: Unique identifier for the case.
                              example: 2025-08-00125
                            created:
                              type: string
                              format: date-time
                              description: When the case was created.
                              example: '2025-07-01T09:12:45Z'
                            updated:
                              type: string
                              format: date-time
                              description: When the case was last updated.
                              example: '2025-07-20T14:03:11Z'
                            createdByUserID:
                              type: string
                              description: ID of the user who created the case.
                              example: 2720f109-0caf-4c62-af22-5d08c853711c
                            createdByOrgID:
                              type: string
                              nullable: true
                              description: Organization ID that created the case, if any.
                              example: cfb40d07-6160-4cbc-899e-5541dec01394
                            phaseID:
                              type: string
                              description: Current phase identifier.
                              example: caseInitiation
                            title:
                              type: string
                              description: Human-readable title for the case.
                              example: Case 2025-08-00125
                            claimantName:
                              type: string
                              nullable: true
                              description: Name of the claimant (may be null).
                              example: Acme Inc
                            respondentName:
                              type: string
                              nullable: true
                              description: Name of the respondent (may be null).
                              example: Mike Smith
                            isCaseClosed:
                              type: boolean
                              description: Whether the case is closed or active.
                              example: false
                        participants:
                          type: array
                          description: People or entities involved in the case.
                          items:
                            type: object
                            properties:
                              created:
                                type: string
                                format: date-time
                                description: When the participant was added.
                                example: '2025-07-02T10:00:00Z'
                              userID:
                                type: string
                                description: ID of the participant user.
                                example: 2b7bd450-342a-47c8-8759-9276e5119be4
                              organizationID:
                                type: string
                                nullable: true
                                description: Organization ID tied to the participant.
                                example: 4190c6ca-647d-4d99-b8b3-991b30ebb378
                              firstName:
                                type: string
                                description: Participants first name.
                                example: Owen
                              lastName:
                                type: string
                                nullable: true
                                description: Optional participants last name.
                                example: Smith
                              partyID:
                                type: string
                                description: Participant party role.
                                example: claimant
                              isPrimary:
                                type: boolean
                                description: >-
                                  Whether this participant is the primary
                                  representative.
                                example: true
                              isObserver:
                                type: boolean
                                description: Whether this participant is an observer.
                                example: false
                        partyID:
                          type: string
                          description: Users party in the case.
                          example: claimant
                  cursor:
                    type: string
                    format: date-time
                    nullable: true
                    description: >-
                      Cursor for fetching the next page (created time of the
                      last case).
                    example: '2025-07-20T14:03:11Z'
                  moreCases:
                    type: boolean
                    description: Indicates if more cases are available to fetch.
                    example: true
              examples:
                default:
                  summary: Example response
                  value:
                    cases:
                      - overview:
                          id: 2025-08-00125
                          created: '2025-07-01T09:12:45Z'
                          updated: '2025-07-20T14:03:11Z'
                          createdByUserID: 2720f109-0caf-4c62-af22-5d08c853711c
                          createdByOrgID: cfb40d07-6160-4cbc-899e-5541dec01394
                          phaseID: caseInitiation
                          title: Case 2025-08-00125
                          claimantName: Acme Inc
                          respondentName: Mike Smith
                        participants:
                          - created: '2025-07-02T10:00:00Z'
                            userID: 2b7bd450-342a-47c8-8759-9276e5119be4
                            organizationID: 4190c6ca-647d-4d99-b8b3-991b30ebb378
                            firstName: Owen
                            lastName: Smith
                            partyID: claimant
                            isPrimary: true
                            isObserver: false
                          - created: '2025-07-02T10:05:00Z'
                            userID: 65edccfa-93f6-4dd5-9421-2b3e1ffe856c
                            organizationID: null
                            firstName: Kyle
                            lastName: Taskman
                            partyID: caseManager
                            isPrimary: false
                            isObserver: false
                        partyID: claimant
                    cursor: '2025-07-20T14:03:11Z'
                    moreCases: true
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````