{
  "opencollection": "1.0.0",
  "info": {
    "name": "HMRC VAT (Making Tax Digital) Liabilities Obligations API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "authorization_code",
      "authorizationUrl": "https://api.service.hmrc.gov.uk/oauth/authorize",
      "accessTokenUrl": "https://api.service.hmrc.gov.uk/oauth/token",
      "credentials": {
        "clientId": "{{clientId}}",
        "clientSecret": "{{clientSecret}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "Obligations",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Retrieve VAT obligations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.service.hmrc.gov.uk/organisations/vat/:vrn/obligations",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              },
              {
                "name": "Gov-Client-Connection-Method",
                "value": ""
              },
              {
                "name": "Gov-Vendor-Version",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "vrn",
                "value": "",
                "type": "path",
                "description": "VAT Registration Number (9 digits)"
              },
              {
                "name": "from",
                "value": "",
                "type": "query",
                "description": "Obligation period start date (YYYY-MM-DD), minimum 2017-01-01"
              },
              {
                "name": "to",
                "value": "",
                "type": "query",
                "description": "Obligation period end date (must be within 366 days of 'from')"
              },
              {
                "name": "status",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Retrieves VAT return filing obligations for the specified VAT Registration Number (VRN). Returns periods for which returns must be filed, due dates, and status (Open, Fulfilled) within the requested date range."
        }
      ]
    }
  ],
  "bundled": true
}