{
  "openapi": "3.0.1",
  "info": {
    "title": "API Umowy NFZ 1.2",
    "version": "1.2"
  },
  "servers": [
    {
      "url": "https://apinfz.nfz.gov.pl/app-umw-api/"
    }
  ],
  "paths": {
    "/service-types": {
      "get": {
        "tags": [
          "Słowniki"
        ],
        "summary": "Słownik rodzajów świadczeń",
        "description": "Zasób zwraca liste rodzajów świadczeń spełniających kryteria wyszukiwania",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "description": "rok.",
            "required": true,
            "schema": {
              "maximum": 9999,
              "minimum": 0,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "code",
            "in": "query",
            "description": "kod rodzaju świadczenia.",
            "schema": {
              "maxLength": 2,
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "nazwa rodzaju świadczenia.",
            "schema": {
              "maxLength": 128,
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie - domyślnie \"name\"\r\n{sortDirection} - opcjonalny parametr kierunku sortowania  - domyślnie \"asc\"\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (domyślnie 10; maks. 25).",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista umów",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/contract-products": {
      "get": {
        "tags": [
          "Słowniki"
        ],
        "summary": "Słownik produktów kontraktowych",
        "description": "Zasób zwraca liste produktów kontraktowych spełniających kryteria wyszukiwania",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "description": "rok",
            "required": true,
            "schema": {
              "maximum": 9999,
              "minimum": 0,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "code",
            "in": "query",
            "description": "kod produktu kontraktowego",
            "schema": {
              "maxLength": 16,
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "nazwa produktu kontraktowego",
            "schema": {
              "maxLength": 250,
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (domyślnie 10; maks. 25).",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie - domyślnie \"name\"\r\n{sortDirection} - opcjonalny parametr kierunku sortowania  - domyślnie \"asc\"\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista umów",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/providers": {
      "get": {
        "tags": [
          "Słowniki"
        ],
        "summary": "Słownik świadczeniodawców",
        "description": "Zasób zwraca listę świadczeniodawców mających podpisaną umowę z NFZ, spełniających kryteria wyszukiwania",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "description": "Rok.",
            "schema": {
              "maximum": 9999,
              "minimum": 0,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "branch",
            "in": "query",
            "description": "Numer oddziału NFZ z którym została podpisana umowa:  <br />\r\n            01 - Dolnonośląski <br />\r\n            02 - Kujawsko-Pomorski <br />\r\n            03 - Lubelski <br />\r\n            04 - Lubuski <br />\r\n            05 - Łódzki <br />\r\n            06 - Małopolski <br />\r\n            07 - Mazowiecki <br />\r\n            08 - Opolski <br />\r\n            09 - Podkarpacki <br />\r\n            10 - Podlaski <br />\r\n            11 - Pomorski <br />\r\n            12 - Śląski <br />\r\n            13 - Świętokrzyski <br />\r\n            14 - Warmińsko-Mazurski <br />\r\n            15 - Wielkopolski <br />\r\n            16 - Zachodniopomorski",
            "schema": {
              "maxLength": 2,
              "type": "string"
            }
          },
          {
            "name": "code",
            "in": "query",
            "description": "Kod świadczeniodawcy.",
            "schema": {
              "maxLength": 24,
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "Nazwa świadczeniodawcy.",
            "schema": {
              "maxLength": 255,
              "type": "string"
            }
          },
          {
            "name": "nip",
            "in": "query",
            "description": "NIP świadczeniodawcy.",
            "schema": {
              "maxLength": 13,
              "type": "string"
            }
          },
          {
            "name": "regon",
            "in": "query",
            "description": "REGON świadczeniodawcy.",
            "schema": {
              "maxLength": 20,
              "type": "string"
            }
          },
          {
            "name": "postCode",
            "in": "query",
            "description": "Kod pocztowy świadczeniodawcy.",
            "schema": {
              "maxLength": 6,
              "type": "string"
            }
          },
          {
            "name": "street",
            "in": "query",
            "description": "Ulica świadczeniodawcy.",
            "schema": {
              "maxLength": 217,
              "type": "string"
            }
          },
          {
            "name": "place",
            "in": "query",
            "description": "Miejscowość świadczeniodawcy.",
            "schema": {
              "maxLength": 100,
              "type": "string"
            }
          },
          {
            "name": "phone",
            "in": "query",
            "description": "Numer telefonu świadczeniodawcy.",
            "schema": {
              "maxLength": 128,
              "type": "string"
            }
          },
          {
            "name": "commune",
            "in": "query",
            "description": "Gmina.",
            "schema": {
              "maxLength": 7,
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie - domyślnie \"name\"\r\n{sortDirection} - opcjonalny parametr kierunku sortowania  - domyślnie \"asc\"\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (domyślnie 10; maks. 25).",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista umów",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-provider-entry-list-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-provider-entry-list-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-provider-entry-list-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-provider-entry-list-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-provider-entry-list-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/providers/{year}": {
      "get": {
        "tags": [
          "Umowy"
        ],
        "summary": "",
        "description": "Zasób zwraca listę świadczeniodawców, którzy mają podpisaną umowę/umowy z NFZ określonych parametrami wyszukiwania",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "description": "Rok podpisania umowy",
            "required": true,
            "schema": {
              "maximum": 9999,
              "minimum": 0,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "branch",
            "in": "query",
            "description": "Numer oddziału z którym została podpisana umowa",
            "schema": {
              "maxLength": 2,
              "type": "string"
            }
          },
          {
            "name": "productCode",
            "in": "query",
            "description": "Kod produktu konraktowanego",
            "schema": {
              "maxLength": 16,
              "type": "string"
            }
          },
          {
            "name": "serviceType",
            "in": "query",
            "description": "Kod rodzaju świadczenia",
            "schema": {
              "maxLength": 2,
              "type": "string"
            }
          },
          {
            "name": "code",
            "in": "query",
            "description": "Kod świadczeniodawcy",
            "schema": {
              "maxLength": 24,
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "Nazwa świadczeniodawcy",
            "schema": {
              "maxLength": 255,
              "type": "string"
            }
          },
          {
            "name": "postCode",
            "in": "query",
            "description": "Kod pocztowy",
            "schema": {
              "maxLength": 6,
              "type": "string"
            }
          },
          {
            "name": "street",
            "in": "query",
            "description": "Ulica",
            "schema": {
              "maxLength": 217,
              "type": "string"
            }
          },
          {
            "name": "place",
            "in": "query",
            "description": "Miejscowość",
            "schema": {
              "maxLength": 100,
              "type": "string"
            }
          },
          {
            "name": "nip",
            "in": "query",
            "description": "Numer NIP",
            "schema": {
              "maxLength": 13,
              "type": "string"
            }
          },
          {
            "name": "regon",
            "in": "query",
            "description": "Regon",
            "schema": {
              "maxLength": 20,
              "type": "string"
            }
          },
          {
            "name": "phone",
            "in": "query",
            "description": "Numer telefony",
            "schema": {
              "maxLength": 128,
              "type": "string"
            }
          },
          {
            "name": "commune",
            "in": "query",
            "description": "Gmina",
            "schema": {
              "maxLength": 7,
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie - domyślnie \"provider-name\"\r\n{sortDirection} - opcjonalny parametr kierunku sortowania  - domyślnie \"asc\"\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (maks. 25)",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa format odpowiedzi.\r\njson — JavaScript object notation\r\nxml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista świadczeniodawców z podpisanyą umową/umowami.",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/providers-list-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/providers-list-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/providers-list-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/providers-list-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/providers-list-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/providers/{year}/{code}": {
      "get": {
        "tags": [
          "Umowy"
        ],
        "summary": "",
        "description": "Zasób zwraca szczegóły świadczeniodawcy wskazanego numerem",
        "operationId": "ProviderDetailsRoute",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "description": "",
            "required": true,
            "schema": {
              "maximum": 9999,
              "minimum": 0,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "branch",
            "in": "query",
            "description": "",
            "required": true,
            "schema": {
              "maxLength": 2,
              "type": "string"
            }
          },
          {
            "name": "code",
            "in": "path",
            "description": "Kod świadczeniodawcy",
            "required": true,
            "schema": {
              "maxLength": 24,
              "type": "string"
            }
          },
          {
            "name": "updatedAt",
            "in": "query",
            "description": "Data aktualizacji umowy. Zwrócone zostąną umowy z datą aktualizacji równą lub większą przekazanej dacie",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (maks. 25)",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa format odpowiedzi.\r\njson — JavaScript object notation\r\nxml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Szczegóły świadczeniodawcy",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/provider-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/provider-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/provider-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/provider-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/provider-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/agreements": {
      "get": {
        "tags": [
          "Umowy"
        ],
        "summary": "",
        "description": "Zasób zwraca listę umów zawartych przez NFZ ze świadczeniodawcami określoną parametrami wyszukiwania",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "description": "Rok podpisania umowy",
            "required": true,
            "schema": {
              "maximum": 9999,
              "minimum": 0,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "branch",
            "in": "query",
            "description": "Numer oddziału NFZ z którym została podpisana umowa:  <br />\r\n            01 - Dolnonośląski <br />\r\n            02 - Kujawsko-Pomorski <br />\r\n            03 - Lubelski <br />\r\n            04 - Lubuski <br />\r\n            05 - Łódzki <br />\r\n            06 - Małopolski <br />\r\n            07 - Mazowiecki <br />\r\n            08 - Opolski <br />\r\n            09 - Podkarpacki <br />\r\n            10 - Podlaski <br />\r\n            11 - Pomorski <br />\r\n            12 - Śląski <br />\r\n            13 - Świętokrzyski <br />\r\n            14 - Warmińsko-Mazurski <br />\r\n            15 - Wielkopolski <br />\r\n            16 - Zachodniopomorski",
            "required": true,
            "schema": {
              "maxLength": 2,
              "type": "string"
            }
          },
          {
            "name": "serviceType",
            "in": "query",
            "description": "Kod rodzaju świadczenia",
            "schema": {
              "maxLength": 2,
              "type": "string"
            }
          },
          {
            "name": "productCode",
            "in": "query",
            "description": "Kod produktu kontraktowego",
            "schema": {
              "maxLength": 16,
              "type": "string"
            }
          },
          {
            "name": "providerCode",
            "in": "query",
            "description": "Kod świadczeniodawcy",
            "schema": {
              "maxLength": 24,
              "type": "string"
            }
          },
          {
            "name": "providerName",
            "in": "query",
            "description": "Nazwa świadczeniodawcy",
            "schema": {
              "maxLength": 255,
              "type": "string"
            }
          },
          {
            "name": "place",
            "in": "query",
            "description": "Miejscowość",
            "schema": {
              "maxLength": 100,
              "type": "string"
            }
          },
          {
            "name": "nip",
            "in": "query",
            "description": "NIP świadczeniodawcy",
            "schema": {
              "maxLength": 13,
              "type": "string"
            }
          },
          {
            "name": "regon",
            "in": "query",
            "description": "REGON świadczeniodawcy",
            "schema": {
              "maxLength": 20,
              "type": "string"
            }
          },
          {
            "name": "updatedAt",
            "in": "query",
            "description": "Data aktualizacji umowy. Zwrócone zostąną umowy z datą aktualizacji większą przekazanej dacie",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie - domyślnie \"origin-code\"\r\n{sortDirection} - opcjonalny parametr kierunku sortowania  - domyślnie \"asc\"\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (domyślnie 10; maks. 25).",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista umów",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-list-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-list-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-list-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-list-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-list-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/agreements/{id}": {
      "get": {
        "tags": [
          "Umowy"
        ],
        "summary": "",
        "description": "Zasób zwraca szczegóły umowy zawartej przez NFZ ze świadczeniodawcą o unikalnym identyfikatorze umowy",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Unikalny identyfikator umowy",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie\r\n{sortDirection} - opcjonalny parametr kierunku sortowania\r\nDostępne wartośći:\r\nASC - Rosnąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (domyślnie 10; maks. 25).",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista umów",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/plans/{id}": {
      "get": {
        "tags": [
          "Umowy"
        ],
        "summary": "",
        "description": "Zasób zwraca szczegółowy plan umowy zawartej przez NFZ ze świadczeniodawcą o wskazanym unikalnym identyfikatorze planu umowy",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Unikalny identyfikator planu umowy",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie\r\n{sortDirection} - opcjonalny parametr kierunku sortowania\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "strona miesięcy w planie umowy",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Ilość miesięcy na stronę",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa format odpowiedzi.\r\njson — JavaScript object notation\r\nxml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Szczegóły planu umowy wraz z miesiącami",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/months/{id}": {
      "get": {
        "tags": [
          "Umowy"
        ],
        "summary": "",
        "description": "Zasób zwraca szczegóły planu miesięcznego o unikalnym identyfikatorze miesiąca w planie umowy, umowy zawartej przez NFZ ze świadczeniodawcą",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Unikalny identyfikator miesiąca w planie umowy",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie\r\n{sortDirection} - opcjonalny parametr kierunku sortowania\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (domyślnie 10; maks. 25).",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Szczegóły miesiąca w planie umowy",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-month-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-month-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-month-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-month-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/agreement-plan-month-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/available-years": {
      "get": {
        "tags": [
          "Umowy"
        ],
        "summary": "",
        "description": "Zwraca informację o przedziale lat za które są dostępne dane",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista umów",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/available-year"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/available-year"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/available-year"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/available-year"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/available-year"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/orthopedic-supplies": {
      "get": {
        "tags": [
          "Słowniki"
        ],
        "summary": "Słownik środków ortopedycznych",
        "description": "Zasób zwraca liste środków ortopedycznych spełniających kryteria wyszukiwania",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "description": "rok.",
            "required": true,
            "schema": {
              "maximum": 9999,
              "minimum": 0,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "code",
            "in": "query",
            "description": "kod środka ortopedycznego.",
            "schema": {
              "maxLength": 16,
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "nazwa środka ortopedycznego.",
            "schema": {
              "maxLength": 250,
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Parametr umożliwa sortowanie po wskazanym atrybucie.\r\nSkładnia: {attributeName}[:{sortDirection}]\r\n{attributeName} - atrybut po którym ma nastąpić sortowanie - domyślnie \"name\"\r\n{sortDirection} - opcjonalny parametr kierunku sortowania  - domyślnie \"asc\"\r\nDostępne wartośći:\r\nASC - Rosnąco\r\nDESC - Malejąco",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Określa liczbę pozycji wyświetlanych na stronie (domyślnie 10; maks. 25).",
            "schema": {
              "maximum": 25,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Określa aktualnie wyświetlaną stronę.\r\n            Określa format odpowiedzi.\r\n            json — JavaScript object notation\r\n            xml — Extensible markup language",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Lista umów",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/dictionary-entry-list-response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/version": {
      "get": {
        "tags": [
          "Info"
        ],
        "summary": "",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "json"
            }
          },
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/version"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/version"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/version"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/version"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/version"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/errors-response"
                }
              }
            }
          }
        }
      }
    },
    "/version/sources": {
      "get": {
        "tags": [
          "Version"
        ],
        "parameters": [
          {
            "name": "api-version",
            "in": "query",
            "description": "The requested API version",
            "schema": {
              "type": "string",
              "default": "1.2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "agreement": {
        "type": "object",
        "properties": {
          "id": {
            "maxLength": 36,
            "type": "string",
            "description": "Identyfikator umowy",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/agreement-attributes"
          },
          "links": {
            "$ref": "#/components/schemas/base-links"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły umowy podpisanej ze świadczeniodawcą\r\nSchema: /schemas/#agreement"
      },
      "agreement-attributes": {
        "type": "object",
        "properties": {
          "code": {
            "maxLength": 24,
            "type": "string",
            "description": "Kod umowy",
            "nullable": true
          },
          "technical-code": {
            "maxLength": 24,
            "type": "string",
            "description": "Techniczny kod umowy przekazywany w ramach UMX, używany w ramach wymiany danych z NFZ",
            "nullable": true
          },
          "origin-code": {
            "maxLength": 50,
            "type": "string",
            "description": "Kod pierwotny umowy",
            "nullable": true
          },
          "service-type": {
            "maxLength": 2,
            "type": "string",
            "description": "Rodzaj świadczenia",
            "nullable": true
          },
          "service-name": {
            "maxLength": 128,
            "type": "string",
            "description": "Nazwa rodzaju świadczenia",
            "nullable": true
          },
          "amount": {
            "multipleOf": 0.01,
            "maximum": 99999999999999,
            "minimum": -99999999999999,
            "type": "number",
            "description": "Kwota",
            "format": "double",
            "nullable": true
          },
          "updated-at": {
            "type": "string",
            "description": "Data aktualizacji danych w centrali. Format: YYYY-MM-DDTHH:MM:SS.SSSSSS",
            "format": "date-time"
          },
          "provider-code": {
            "maxLength": 24,
            "type": "string",
            "description": "Kod świadczeniodawcy",
            "nullable": true
          },
          "provider-nip": {
            "maxLength": 13,
            "type": "string",
            "description": "Numer NIP",
            "nullable": true
          },
          "provider-regon": {
            "maxLength": 20,
            "type": "string",
            "description": "Numer REGON",
            "nullable": true
          },
          "provider-registry-number": {
            "maxLength": 128,
            "type": "string",
            "description": "Numer księgi rejestrowej",
            "nullable": true
          },
          "provider-name": {
            "maxLength": 255,
            "type": "string",
            "description": "Nazwa świadczeniodawcy",
            "nullable": true
          },
          "provider-place": {
            "maxLength": 100,
            "type": "string",
            "description": "Miejscowość świadczeniodawcy",
            "nullable": true
          },
          "year": {
            "maximum": 9999,
            "minimum": 0,
            "type": "integer",
            "description": "Rok",
            "format": "int32"
          },
          "branch": {
            "maxLength": 2,
            "type": "string",
            "description": "Oddział świadczeniodawcy",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty umowy\r\nSchema: /schemas/#agreement-attributes"
      },
      "agreement-data": {
        "type": "object",
        "properties": {
          "agreement": {
            "$ref": "#/components/schemas/agreement"
          },
          "plans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/agreement-plan"
            },
            "description": "Lista planów umowy",
            "nullable": true
          },
          "orthopedic-supplies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/orthopedic-supply"
            },
            "description": "Lista wyrobów medycznych",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Szczególy umowy\r\nSchema: /schemas/#agreement-data"
      },
      "agreement-list-data": {
        "type": "object",
        "properties": {
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/agreement"
            },
            "description": "Lista umów",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Dane dotyczące listy umów\r\nSchema: /schemas/#agreement-list-data"
      },
      "agreement-list-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/agreement-list-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie listy umów"
      },
      "agreement-month-header": {
        "type": "object",
        "properties": {
          "year": {
            "maximum": 9999,
            "minimum": 0,
            "type": "integer",
            "description": "Rok",
            "format": "int32"
          },
          "branch": {
            "maxLength": 2,
            "type": "string",
            "description": "Oddział wojewódzki",
            "nullable": true
          },
          "provider-code": {
            "maxLength": 24,
            "type": "string",
            "description": "Kod świadczeniodawcy",
            "nullable": true
          },
          "provider-name": {
            "maxLength": 255,
            "type": "string",
            "description": "Nazwa świadczeniodawcy",
            "nullable": true
          },
          "order": {
            "maximum": 9999,
            "minimum": -9999,
            "type": "integer",
            "description": "Wyróżnik",
            "format": "int32",
            "nullable": true
          },
          "agreement-code": {
            "maxLength": 24,
            "type": "string",
            "description": "Kod umowy",
            "nullable": true
          },
          "service-type-name": {
            "maxLength": 128,
            "type": "string",
            "description": "Nazwa rodzaju świadczenia",
            "nullable": true
          },
          "contract-product-code": {
            "maxLength": 16,
            "type": "string",
            "description": "Produkt kontraktowy",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Nagłówek odpowiedzi planu umowy w rozbicu na miesiące\r\nSchema: /schemas/#agreement-month-header"
      },
      "agreement-package": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/agreement-package-attributes"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły pakietu umowy dla danego punktu umowy w danym miesiącu\r\nSchema: /schemas/#agreement-package"
      },
      "agreement-package-attributes": {
        "type": "object",
        "properties": {
          "unit-product-code": {
            "maxLength": 16,
            "type": "string",
            "description": "Kod produktu jednostkowego",
            "nullable": true
          },
          "unit-product-name": {
            "maxLength": 250,
            "type": "string",
            "description": "Nazwa produktu jednostkowego",
            "nullable": true
          },
          "weight": {
            "multipleOf": 0.0001,
            "maximum": 9999999999,
            "minimum": 0,
            "type": "number",
            "description": "Waga efektywna",
            "format": "double"
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty pakietu umowy dla danego punktu umowy w danym miesiącu\r\nSchema: /schemas/#agreement-package-attributes"
      },
      "agreement-plan": {
        "type": "object",
        "properties": {
          "id": {
            "maxLength": 36,
            "type": "string",
            "description": "Identyfikator umowy",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/agreement-plan-attributes"
          },
          "links": {
            "$ref": "#/components/schemas/base-links"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły planu umowy\r\nSchema: /schemas/#agreement-plan"
      },
      "agreement-plan-attributes": {
        "type": "object",
        "properties": {
          "product-code": {
            "maxLength": 16,
            "type": "string",
            "description": "Kod produktu kontraktowego",
            "nullable": true
          },
          "product-name": {
            "maxLength": 250,
            "type": "string",
            "description": "Nazwa produktu kontraktowego",
            "nullable": true
          },
          "order": {
            "maximum": 9999,
            "minimum": -9999,
            "type": "integer",
            "description": "Wyróżnik produktu w planie umowy",
            "format": "int32"
          },
          "unit-count": {
            "type": "number",
            "description": "Sumaryczna liczba kontraktu dla produktu",
            "format": "double"
          },
          "price": {
            "type": "number",
            "description": "Sumaryczna kwota kontraktu dla produktu",
            "format": "double"
          },
          "avg-price": {
            "type": "number",
            "description": "Średnia cena produktu",
            "format": "double"
          },
          "date-from": {
            "type": "string",
            "description": "Data początku obowiązywania produktu kontraktowego w planie umowy. Format: YYYY-MM-DD",
            "format": "date-time",
            "nullable": true
          },
          "date-to": {
            "type": "string",
            "description": "Data końca obowiązywania produktu kontraktowego w planie umowy. Format: YYYY-MM-DD",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty planu umowy\r\nSchema: /schemas/#agreement-plan-attributes"
      },
      "agreement-plan-data": {
        "type": "object",
        "properties": {
          "header": {
            "$ref": "#/components/schemas/agreement-plan-header"
          },
          "agreement-plan": {
            "$ref": "#/components/schemas/agreement-plan"
          },
          "months": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/agreement-plan-month"
            },
            "description": "Lista planów umowy",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Szczególy umowy\r\nSchema: /schemas/#agreement-plan-data"
      },
      "agreement-plan-header": {
        "type": "object",
        "properties": {
          "year": {
            "maximum": 9999,
            "minimum": 0,
            "type": "integer",
            "description": "Rok",
            "format": "int32"
          },
          "branch": {
            "maxLength": 2,
            "type": "string",
            "description": "Oddział wojewódzki",
            "nullable": true
          },
          "provider-code": {
            "maxLength": 24,
            "type": "string",
            "description": "Kod świadczeniodawcy",
            "nullable": true
          },
          "provider-name": {
            "maxLength": 255,
            "type": "string",
            "description": "Nazwa świadczeniodawcy",
            "nullable": true
          },
          "agreement-code": {
            "maxLength": 24,
            "type": "string",
            "description": "Kod umowy",
            "nullable": true
          },
          "service-type-name": {
            "maxLength": 128,
            "type": "string",
            "description": "Nazwa rodzaju świadczenia",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Nagłówek planu umowy\r\nSchema: /schemas/#agreement-plan-header"
      },
      "agreement-plan-month": {
        "type": "object",
        "properties": {
          "id": {
            "maxLength": 36,
            "type": "string",
            "description": "Identyfikator techniczny miesiąca w planie umowy",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/agreement-plan-month-attributes"
          },
          "links": {
            "$ref": "#/components/schemas/base-links"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły planu umowy w rozbiciu na miesiące\r\nSchema: /schemas/#agreement-plan-month"
      },
      "agreement-plan-month-attributes": {
        "type": "object",
        "properties": {
          "unit-count": {
            "multipleOf": 0.0001,
            "maximum": 1000000000000,
            "minimum": 0,
            "type": "number",
            "description": "Liczba produktów w danym miesiącu",
            "format": "double"
          },
          "month": {
            "maximum": 12,
            "minimum": 1,
            "type": "integer",
            "description": "Miesiąc",
            "format": "int32"
          },
          "price": {
            "multipleOf": 0.01,
            "maximum": 1000000000000,
            "minimum": -1000000000000,
            "type": "number",
            "description": "Sumaryczna kwota kontraktu dla produktu",
            "format": "double"
          },
          "packages-type": {
            "maxLength": 1,
            "type": "string",
            "description": "Typ pakietów",
            "nullable": true
          },
          "avg-price": {
            "type": "number",
            "description": "Średnia cena produktu",
            "format": "double"
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty miesiąca w planie umowy\r\nSchema: /schemas/#agreement-plan-month-attributes"
      },
      "agreement-plan-month-data": {
        "type": "object",
        "properties": {
          "header": {
            "$ref": "#/components/schemas/agreement-month-header"
          },
          "month": {
            "$ref": "#/components/schemas/agreement-plan-month"
          },
          "packages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/agreement-package"
            },
            "description": "Lista pakietów w miesiącu umowy",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Szczególy umowy\r\nSchema: /schemas/#agreement-plan-month-data"
      },
      "agreement-plan-month-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/agreement-plan-month-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie szczegółów miesiąca planu umowy\r\nSchema: /#structure"
      },
      "agreement-plan-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/agreement-plan-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie szczegółów planu umowy"
      },
      "agreement-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/agreement-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie szczegółów umowy"
      },
      "api-version": {
        "type": "object",
        "properties": {
          "major": {
            "type": "integer",
            "description": "Numer major wersji",
            "format": "int32"
          },
          "minor": {
            "type": "integer",
            "description": "Numer minor wersji",
            "format": "int32"
          },
          "patch": {
            "type": "integer",
            "description": "Numer patch wersji",
            "format": "int32"
          },
          "date-mod": {
            "type": "string",
            "description": "Data modifikacji zasobu",
            "nullable": true
          },
          "deprecated": {
            "type": "boolean",
            "description": "Określa czy dana wersja jest przestarzała"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły dotyczące wersji api"
      },
      "available-year": {
        "type": "object",
        "properties": {
          "start-year": {
            "type": "integer",
            "description": "Rok początkowy",
            "format": "int32"
          },
          "end-year": {
            "type": "integer",
            "description": "Rok końcowy",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Dostępny minimalny i maksymalny rok za który dostępne są dane"
      },
      "base-links": {
        "type": "object",
        "properties": {
          "related": {
            "type": "string",
            "description": "Link do zasobu powiązanego",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Podstawowe linki nawigujące\r\nWięcej informacji: https://api.nfz.gov.pl/app-umw-api/#links"
      },
      "dictionary-entry": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/dictionary-entry-attributes"
          }
        },
        "additionalProperties": false,
        "description": "Pozycja słownikowa\r\nSchema: /schemas/#dictionary-entry"
      },
      "dictionary-entry-attributes": {
        "type": "object",
        "properties": {
          "code": {
            "maxLength": 16,
            "type": "string",
            "description": "Kod pozycji",
            "nullable": true
          },
          "name": {
            "maxLength": 240,
            "type": "string",
            "description": "Nazwa pozycji",
            "nullable": true
          },
          "year": {
            "maximum": 9999,
            "minimum": 0,
            "type": "integer",
            "description": "Rok",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty pozycji słownikowej\r\nSchema: /schemas/#dictionary-entry-attributes"
      },
      "dictionary-entry-list-data": {
        "type": "object",
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/dictionary-entry"
            },
            "description": "Lista pozycji ze słownika",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Dane dotyczące listy pozycji ze słownika\r\nSchema: /schemas/#dictionary-entry-list-data"
      },
      "dictionary-entry-list-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/dictionary-entry-list-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie zasobu słownikowego"
      },
      "dictionary-provider-entry": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/dictionary-provider-entry-attributes"
          }
        },
        "additionalProperties": false,
        "description": "Pozycja słownikowa świadczeniodawcy\r\nSchema: /schemas/#dictionary-provider-entry"
      },
      "dictionary-provider-entry-attributes": {
        "type": "object",
        "properties": {
          "branch": {
            "type": "string",
            "description": "Oddział Wojewódzki NFZ",
            "nullable": true
          },
          "code": {
            "type": "string",
            "description": "Kod świadczeniodawcy",
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "Nazwa świadczeniodawcy",
            "nullable": true
          },
          "nip": {
            "type": "string",
            "description": "Numer NIP",
            "nullable": true
          },
          "regon": {
            "type": "string",
            "description": "Numer REGON",
            "nullable": true
          },
          "registry-number": {
            "type": "string",
            "description": "Numer księgi rejestrowej",
            "nullable": true
          },
          "post-code": {
            "type": "string",
            "description": "Kod pocztowy",
            "nullable": true
          },
          "street": {
            "type": "string",
            "description": "Ulica",
            "nullable": true
          },
          "place": {
            "type": "string",
            "description": "Miejscowość",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "description": "Numer telefonu",
            "nullable": true
          },
          "commune": {
            "type": "string",
            "description": "Gmina",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty pozycji słownika świadczeniodawców\r\nSchema: /schemas/#dictionary-provider-entry"
      },
      "dictionary-provider-entry-list-data": {
        "type": "object",
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/dictionary-provider-entry"
            },
            "description": "Lista pozycji ze słownika",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Dane dotyczące listy pozycji ze słownika śwadczeniodawców\r\nSchema: /schemas/#dictionary-provider-list-data"
      },
      "dictionary-provider-entry-list-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/dictionary-provider-entry-list-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie zasobu słownikowego świadczeniodawców"
      },
      "error": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identyfikator",
            "format": "uuid"
          },
          "error-result": {
            "type": "string",
            "description": "Wynik",
            "nullable": true
          },
          "error-reason": {
            "type": "string",
            "description": "Przyczyna błędu",
            "nullable": true
          },
          "error-solution": {
            "type": "string",
            "description": "Zalecane działanie",
            "nullable": true
          },
          "error-help": {
            "type": "string",
            "description": "Pomoc",
            "nullable": true
          },
          "error-code": {
            "type": "integer",
            "description": "Kod błędu",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły błędu"
      },
      "errors-response": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/error"
            },
            "description": "Lista błędów",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź z informacją na temat błędów"
      },
      "extended-metadata": {
        "type": "object",
        "properties": {
          "@context": {
            "type": "string",
            "description": "Link do kontekstu wyjaśniającego model",
            "nullable": true
          },
          "count": {
            "type": "integer",
            "description": "Liczba znalezionych pozycji",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "description": "Aktualnie przeglądana strona",
            "format": "int32"
          },
          "limit": {
            "type": "integer",
            "description": "Liczba pozycji na stronę",
            "format": "int32"
          },
          "title": {
            "type": "string",
            "description": "Tytuł",
            "nullable": true
          },
          "url": {
            "type": "string",
            "description": "Url zasobu",
            "nullable": true
          },
          "provider": {
            "type": "string",
            "description": "Dostawca",
            "nullable": true
          },
          "date-published": {
            "type": "string",
            "description": "Data publikacji zasobu",
            "nullable": true
          },
          "date-modified": {
            "type": "string",
            "description": "Data modyfikacji zasobu",
            "nullable": true
          },
          "description": {
            "type": "string",
            "description": "Opis",
            "nullable": true
          },
          "keywords": {
            "type": "string",
            "description": "Słowa kluczowe",
            "nullable": true
          },
          "language": {
            "type": "string",
            "description": "Język",
            "nullable": true
          },
          "content-type": {
            "type": "string",
            "description": "MIME",
            "nullable": true
          },
          "is-part-of": {
            "type": "string",
            "description": "Określa przynależność do grupy",
            "nullable": true
          },
          "version": {
            "type": "string",
            "description": "Wskazuję wersję API",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Metadane\r\nWięcej informacji: https://api.nfz.gov.pl/app-umw-api/metadata"
      },
      "links": {
        "type": "object",
        "properties": {
          "first": {
            "type": "string",
            "description": "Link do pierwszej strony ze znalezionymi pozycjami",
            "nullable": true
          },
          "prev": {
            "type": "string",
            "description": "Link do poprzedniej strony ze znalezionymi pozycjami",
            "nullable": true
          },
          "self": {
            "type": "string",
            "description": "Link aktualnej strony ze znalezionymi pozycjami",
            "nullable": true
          },
          "next": {
            "type": "string",
            "description": "Link do następnej strony ze znalezionymi pozycjami",
            "nullable": true
          },
          "last": {
            "type": "string",
            "description": "Link do ostatniej strony ze znalezionymi pozycjami",
            "nullable": true
          },
          "related": {
            "type": "string",
            "description": "Link do zasobu powiązanego",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Linki nawigujące HATEOS\r\nWięcej informacji: https://api.nfz.gov.pl/app-umw-api/#links"
      },
      "orthopedic-supply": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/orthopedic-supply-attributes"
          },
          "links": {
            "$ref": "#/components/schemas/base-links"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły wyrobu medycznego\r\nSchema: /schemas/#orthopedic-supply"
      },
      "orthopedic-supply-attributes": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Kod wyrobu medycznego",
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "Nazwa wyrobu medycznego",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty planu umowy\r\nSchema: /schemas/#orthopedic-supply-attributes"
      },
      "provider": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Typ obiektu",
            "nullable": true
          },
          "attributes": {
            "$ref": "#/components/schemas/provider-attributes"
          },
          "links": {
            "$ref": "#/components/schemas/base-links"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły świadczeniodawcy\r\nSchema: /schemas/#provider"
      },
      "provider-attributes": {
        "type": "object",
        "properties": {
          "branch": {
            "type": "string",
            "description": "Oddział Wojewódzki",
            "nullable": true
          },
          "code": {
            "type": "string",
            "description": "Kod świadczniodawcy",
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "Nazwa świadczeniodawcy",
            "nullable": true
          },
          "nip": {
            "type": "string",
            "description": "Numer NIP",
            "nullable": true
          },
          "regon": {
            "type": "string",
            "description": "Regon",
            "nullable": true
          },
          "registry-number": {
            "type": "string",
            "description": "Numer księgi rejestrowej",
            "nullable": true
          },
          "post-code": {
            "type": "string",
            "description": "Kod pocztowy",
            "nullable": true
          },
          "street": {
            "type": "string",
            "description": "Ulica",
            "nullable": true
          },
          "place": {
            "type": "string",
            "description": "Miejscowość",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "description": "Numer telefonu",
            "nullable": true
          },
          "commune": {
            "type": "string",
            "description": "Gmina",
            "nullable": true
          },
          "amount": {
            "multipleOf": 0.01,
            "type": "number",
            "description": "Sumaryczna kwota zobowiązań",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Atrybuty świadczeniodawcy\r\nSchema: /schemas/#provider-attributes"
      },
      "provider-data": {
        "type": "object",
        "properties": {
          "provider": {
            "$ref": "#/components/schemas/provider"
          },
          "agreements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/agreement"
            },
            "description": "Lista umów świadczeniodawcy",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły świadczeniodawcy\r\nSchema: /schemas/#provider-data"
      },
      "provider-list-data": {
        "type": "object",
        "properties": {
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/provider"
            },
            "description": "Lista świadczeniodawców",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Dane dotyczące listy świadczeniodawców\r\nSchema: /schemas/#provider-list-data"
      },
      "provider-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/provider-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie szczegółów świadczeniodawcy."
      },
      "providers-list-response": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/extended-metadata"
          },
          "links": {
            "$ref": "#/components/schemas/links"
          },
          "data": {
            "$ref": "#/components/schemas/provider-list-data"
          }
        },
        "additionalProperties": false,
        "description": "Odpowiedź na żądanie listy świadczeniodawców"
      },
      "version": {
        "type": "object",
        "properties": {
          "api-version": {
            "$ref": "#/components/schemas/api-version"
          }
        },
        "additionalProperties": false,
        "description": "Szczegóły dotyczące wersji API"
      }
    },
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "description": "ApiKey must appear in header",
        "name": "ApiKey",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "ApiKey": [ ]
    }
  ]
}