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

# Search status updates across mandates

> Lists published status updates across all main and sub-cases of your company. Results use the status date when provided and the creation timestamp otherwise, newest first.



## OpenAPI

````yaml get /v1/statusupdates/
openapi: 3.0.3
info:
  title: paywise Case Management API
  version: v1
  description: |

    Use our Case Management API to perform the debt entire collection process.

    Please refer to the [official docs][ref1] for more!

    [ref1]: https://docs.paywise.de/api-docs/case-management-api/introduction
servers:
  - url: https://api.paywise.de
    description: Production environment
security: []
externalDocs:
  url: https://docs.paywise.de/api-docs/case-management-api/
paths:
  /v1/statusupdates/:
    get:
      tags:
        - statusupdates
      summary: Search status updates across mandates
      description: >-
        Lists published status updates across all main and sub-cases of your
        company. Results use the status date when provided and the creation
        timestamp otherwise, newest first.
      operationId: list-status-updates
      parameters:
        - in: query
          name: created_after
          schema:
            type: string
            format: date-time
          description: >-
            Include updates whose effective status timestamp is on or after this
            ISO 8601 timestamp.
        - in: query
          name: created_before
          schema:
            type: string
            format: date-time
          description: >-
            Include updates whose effective status timestamp is on or before
            this ISO 8601 timestamp.
        - in: query
          name: legal_stage
          schema:
            type: string
            enum:
              - ended
              - extrajudicial
              - foreclosure
              - judicial_dunning
              - long_term_monitoring
          description: Filter by the legal stage stored on the update.
        - name: limit
          required: false
          in: query
          description: Anzahl der pro Seite zurückzugebenden Ergebnisse.
          schema:
            type: integer
        - in: query
          name: mandate
          schema:
            type: string
            format: uuid
          description: Filter by the publishing mandate ID.
        - name: offset
          required: false
          in: query
          description: >-
            Der initiale Index, von dem die Ergebnisse zurückgegeben werden
            sollen.
          schema:
            type: integer
        - in: query
          name: processing_state
          schema:
            type: string
            enum:
              - canceled_by_client
              - canceled_by_service_provider
              - ended
              - in_progress
              - paused
          description: Filter by the processing state stored on the update.
        - in: query
          name: q
          schema:
            type: string
          description: >-
            Case-insensitive substring search in title and HTML-free
            description, or an exact case-insensitive event code. The search
            term must contain at least 3 characters.
        - in: query
          name: reference_number
          schema:
            type: string
          description: Filter by a current or historical case reference number.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedStatusUpdateCollectionList'
              examples:
                Cross-mandateStatusUpdate:
                  value:
                    count: 123
                    next: http://api.example.org/accounts/?offset=400&limit=100
                    previous: http://api.example.org/accounts/?offset=200&limit=100
                    results:
                      - id: 095be615-a8ad-4c33-8e9c-c7612fbf6c9f
                        title: Vollstreckung eingeleitet
                        description: <p>Die Vollstreckung wurde eingeleitet.</p>
                        legal_stage: foreclosure
                        processing_state: in_progress
                        created: '2026-08-20T10:23:45.678901Z'
                        downloads:
                          - id: a1b2c3d4-e5f6-7890-1234-567890abcdef
                            filename: vollstreckungsnachweis.pdf
                            mime_type: application/pdf
                            download_url: >-
                              https://api.paywise.de/v1/mandates/5600672e-2bfa-488c-b23a-460c1dd1f833/statusupdates/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/download/a1b2c3d4-e5f6-7890-1234-567890abcdef/
                        mandate: 5600672e-2bfa-488c-b23a-460c1dd1f833
                        reference_number: K26-3014A
                  summary: Cross-mandate status update
                  description: >-
                    Published status update with the publishing mandate and main
                    case reference.
          description: ''
      security:
        - tokenAuth: []
        - tokenAuth: []
components:
  schemas:
    PaginatedStatusUpdateCollectionList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/StatusUpdateCollection'
    StatusUpdateCollection:
      type: object
      description: Status payload plus its publishing case and main case reference.
      properties:
        id:
          type: string
        title:
          type: string
          readOnly: true
        description:
          type: string
          readOnly: true
          nullable: true
          title: Text
        legal_stage:
          allOf:
            - $ref: '#/components/schemas/LegalStageEnum'
          readOnly: true
        processing_state:
          allOf:
            - $ref: '#/components/schemas/ProcessingStateEnum'
          readOnly: true
        created:
          type: string
          format: date-time
          readOnly: true
        downloads:
          type: array
          items:
            $ref: '#/components/schemas/StatusUpdateCollectionDownload'
          readOnly: true
          description: List of file attachments with metadata and download URLs.
        mandate:
          type: string
          format: uuid
          readOnly: true
          description: ID of the mandate that published this status update.
        reference_number:
          type: string
          readOnly: true
          nullable: true
          description: Reference number of the main case.
      required:
        - created
        - description
        - downloads
        - legal_stage
        - mandate
        - processing_state
        - reference_number
        - title
    LegalStageEnum:
      enum:
        - extrajudicial
        - judicial_dunning
        - foreclosure
        - long_term_monitoring
        - ended
      type: string
      description: |-
        * `extrajudicial` - Außergerichtlich
        * `judicial_dunning` - Gerichtliches Mahnverfahren
        * `foreclosure` - Zwangsvollstreckung
        * `long_term_monitoring` - In Langzeitüberwachung
        * `ended` - Beendet
    ProcessingStateEnum:
      enum:
        - in_progress
        - paused
        - canceled_by_client
        - canceled_by_service_provider
        - ended
      type: string
      description: |-
        * `in_progress` - Laufend
        * `paused` - Pausiert
        * `canceled_by_client` - Abgebrochen durch Mandant
        * `canceled_by_service_provider` - Abgebrochen durch uns
        * `ended` - Beendet
    StatusUpdateCollectionDownload:
      type: object
      description: Attachment metadata that never requires an object-storage lookup.
      properties:
        id:
          type: string
          format: uuid
          description: Unique UUID identifier of the file attachment
        filename:
          type: string
          description: Original filename of the attachment
        mime_type:
          type: string
          description: MIME type of the file
        download_url:
          type: string
          format: uri
          description: Secure download URL for the file
      required:
        - download_url
        - filename
        - id
        - mime_type
  securitySchemes:
    tokenAuth:
      type: http
      scheme: bearer

````