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

# List status updates

> Lists all status updates of a mandate.



## OpenAPI

````yaml get /v1/mandates/{id}/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/mandates/{id}/statusupdates/:
    get:
      tags:
        - mandates
      summary: List status updates
      description: Lists all status updates of a mandate.
      operationId: list-mandate-status
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusUpdates'
              examples:
                StatusUpdateWithDownloadsExample:
                  value:
                    id: 095be615-a8ad-4c33-8e9c-c7612fbf6c9f
                    title: Erste Zahlungsaufforderung
                    description: >-
                      <p>Wir haben Ihrem Schuldner unsere erste
                      Zahlungsaufforderung gesendet.</p>
                    legal_stage: dunning
                    processing_state: open
                    created: '2023-07-15T10:23:45.678901Z'
                    downloads:
                      - id: a1b2c3d4-e5f6-7890-1234-567890abcdef
                        filename: zahlungsaufforderung.pdf
                        mime_type: application/pdf
                        file_size: 145632
                        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/
                      - id: f6e5d4c3-b2a1-9876-5432-1abcdef67890
                        filename: einschreiben_nachweis.jpg
                        mime_type: image/jpeg
                        file_size: 89421
                        download_url: >-
                          https://api.paywise.de/v1/mandates/5600672e-2bfa-488c-b23a-460c1dd1f833/statusupdates/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/download/f6e5d4c3-b2a1-9876-5432-1abcdef67890/
                  summary: Status Update with Downloads Example
                  description: Example of a status update object with file downloads
          description: ''
      security:
        - tokenAuth: []
        - tokenAuth: []
components:
  schemas:
    StatusUpdates:
      type: object
      description: |-
        Mixin to provide download URLs for status update file attachments.
        Reusable across different status update serializers.
      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/StatusUpdateDownload'
          readOnly: true
          description: List of file attachments with metadata and download URLs.
      required:
        - created
        - description
        - downloads
        - legal_stage
        - processing_state
        - 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
    StatusUpdateDownload:
      type: object
      description: |-
        Serializer for individual download objects in status updates.
        Used for schema generation and documentation.
      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 (e.g., application/pdf, image/jpeg)
        file_size:
          type: integer
          nullable: true
          description: File size in bytes
        download_url:
          type: string
          format: uri
          description: Secure download URL for the file
      required:
        - download_url
        - file_size
        - filename
        - id
        - mime_type
  securitySchemes:
    tokenAuth:
      type: http
      scheme: bearer

````