Open the dialog of an institution that answered the status with DialogAndResult (GetDialog): returns the dialog messages to be answered, or its processing / error / not-supported state

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://restapi.wyzio.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Wyzio MCP server": {
    "url": "https://restapi.wyzio.com/mcp"
  }
}

POST /api-v1/swissdec/salary-declaration/{jobKey}/institutions/{domainStatusId}/dialog

Headers

WEAL-TOKEN Required

API token (can be retrieved from account settings)
TARGET-ORGANIZATION-ID

ID of organization, for which the operation must be performed

Path parameters

jobKey string Required
domainStatusId integer(int64) Required

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- domainStatusId integer(int64)
- domain string
  
  Values are AHV_AVS, BVG_LPP, UVG_LAA, UVGZ_LAAC, KTG_AMC, FAK_CAF, TAX, TAX_AT_SOURCE, TAX_CROSSBORDER, STATISTIC, or UNEMPLOYMENT_CERTIFICATES.
- institutionIdRef string
- institutionName string
- state string
  
  Values are OPEN, COMPLETED, PROCESSING, ERROR, NOT_SUPPORTED, or FAULT.
- fetchedDate string(date-time)
- expectedAvailability string(date-time)
- endUserInformation string
- detailInformation string
- responseId string
- requestId string
- notifications array[object]
  
  Hide notifications attributes Show notifications attributes object
  
  level string
  
  Values are WARNING or INFO.
  
  qualityLevel string
  
  descriptionCode string
  
  description string
  
  stage string
  
  Values are STATUS, RESULT, or DIALOG.
- messages array[object]
  
  Hide messages attributes Show messages attributes object
  
  storyId string
  
  standardDialogId string
  
  creation string(date-time)
  
  title string
  
  description string
  
  sections array[object]
  
  Hide sections attributes Show sections attributes object
  
  sectionId string
  
  heading string
  
  description string
  
  paragraphs array[object]
  
  Hide paragraphs attributes Show paragraphs attributes object
  
  id integer(int32)
  
  label string
  
  sectionIdRef string
  
  valueType string
  
  Values are STRING, INTEGER, DOUBLE, BOOLEAN, DATE, DATE_TIME, YES_NO_UNKNOWN, or AMOUNT.
  
  value string
  
  answerType string
  
  Values are STRING, INTEGER, DOUBLE, BOOLEAN, DATE, DATE_TIME, YES_NO_UNKNOWN, or AMOUNT.
  
  answerDefault string
  
  answerValue string
  
  answerOptional boolean
  
  problem string
400

400 Bad Request
401

401 Unauthorized
403

403 Access Denied
404

404 Not Found
500

500 Internal Server Error

POST /api-v1/swissdec/salary-declaration/{jobKey}/institutions/{domainStatusId}/dialog

curl \
 --request POST 'https://wyzio.app/api-v1/swissdec/salary-declaration/{jobKey}/institutions/{domainStatusId}/dialog'

Response examples (200)

{
  "domainStatusId": 42,
  "domain": "AHV_AVS",
  "institutionIdRef": "string",
  "institutionName": "string",
  "state": "OPEN",
  "fetchedDate": "2026-05-04T09:42:00Z",
  "expectedAvailability": "2026-05-04T09:42:00Z",
  "endUserInformation": "string",
  "detailInformation": "string",
  "responseId": "string",
  "requestId": "string",
  "notifications": [
    {
      "level": "WARNING",
      "qualityLevel": "string",
      "descriptionCode": "string",
      "description": "string",
      "stage": "STATUS"
    }
  ],
  "messages": [
    {
      "storyId": "string",
      "standardDialogId": "string",
      "creation": "2026-05-04T09:42:00Z",
      "title": "string",
      "description": "string",
      "sections": [
        {
          "sectionId": "string",
          "heading": "string",
          "description": "string"
        }
      ],
      "paragraphs": [
        {
          "id": 42,
          "label": "string",
          "sectionIdRef": "string",
          "valueType": "STRING",
          "value": "string",
          "answerType": "STRING",
          "answerDefault": "string",
          "answerValue": "string",
          "answerOptional": true,
          "problem": "string"
        }
      ]
    }
  ]
}