{
  "info": {
    "_postman_id": "db6e1c82-6258-4b53-bae6-abb9629fdd6c",
    "name": "HMRC VAT (Making Tax Digital) Liabilities Payments API",
    "description": "The HMRC VAT Making Tax Digital (MTD) API enables VAT-registered businesses and agents to submit VAT returns, view VAT obligations, liabilities, and payments, in compliance with UK Making Tax Digital requirements. Requires OAuth 2.0 authentication and mandatory fraud prevention headers on all requests.\n\nContact Support:\n Name: HMRC Developer Hub",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T01:56:11.000Z",
    "updatedAt": "2026-07-28T01:56:11.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-db6e1c82-6258-4b53-bae6-abb9629fdd6c"
  },
  "item": [
    {
      "name": "organisations",
      "item": [
        {
          "name": "vat",
          "item": [
            {
              "name": "{vrn}",
              "item": [
                {
                  "name": "payments",
                  "item": [
                    {
                      "name": "Retrieve VAT payments",
                      "id": "a5a5621d-e79a-44b0-a857-4da52b411665",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/organisations/vat/:vrn/payments?from=<date>&to=<date>",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "organisations",
                            "vat",
                            ":vrn",
                            "payments"
                          ],
                          "query": [
                            {
                              "description": "(Required) ",
                              "key": "from",
                              "value": "<date>"
                            },
                            {
                              "description": "(Required) ",
                              "key": "to",
                              "value": "<date>"
                            }
                          ],
                          "variable": [
                            {
                              "id": "9c08696f-55fc-4139-8a68-18b397dd5e21",
                              "key": "vrn",
                              "value": "214488232",
                              "description": "(Required) "
                            }
                          ]
                        },
                        "description": "Retrieves a list of VAT payments made by the business to HMRC within the specified date range."
                      },
                      "response": [
                        {
                          "id": "e3ca7f09-2caf-4bdc-b9f4-ab6dedc53a1c",
                          "name": "Payment list returned",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/organisations/vat/:vrn/payments?from=<date>&to=<date>",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "organisations",
                                "vat",
                                ":vrn",
                                "payments"
                              ],
                              "query": [
                                {
                                  "description": "(Required) ",
                                  "key": "from",
                                  "value": "<date>"
                                },
                                {
                                  "description": "(Required) ",
                                  "key": "to",
                                  "value": "<date>"
                                }
                              ],
                              "variable": [
                                {
                                  "key": "vrn"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"payments\": [\n    {\n      \"amount\": \"<number>\",\n      \"received\": \"<date>\"\n    },\n    {\n      \"amount\": \"<number>\",\n      \"received\": \"<date>\"\n    }\n  ]\n}",
                          "createdAt": "2026-07-28T01:56:11.000Z",
                          "updatedAt": "2026-07-28T01:56:11.000Z",
                          "uid": "35240-e3ca7f09-2caf-4bdc-b9f4-ab6dedc53a1c"
                        },
                        {
                          "id": "543a933b-3b13-472c-8a26-ff98180e7f57",
                          "name": "No payments found",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "description": "Added as a part of security scheme: oauth2",
                                "key": "Authorization",
                                "value": "<token>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/organisations/vat/:vrn/payments?from=<date>&to=<date>",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "organisations",
                                "vat",
                                ":vrn",
                                "payments"
                              ],
                              "query": [
                                {
                                  "description": "(Required) ",
                                  "key": "from",
                                  "value": "<date>"
                                },
                                {
                                  "description": "(Required) ",
                                  "key": "to",
                                  "value": "<date>"
                                }
                              ],
                              "variable": [
                                {
                                  "key": "vrn"
                                }
                              ]
                            }
                          },
                          "status": "Not Found",
                          "code": 404,
                          "_postman_previewlanguage": "text",
                          "header": [],
                          "cookie": [],
                          "responseTime": null,
                          "body": null,
                          "createdAt": "2026-07-28T01:56:11.000Z",
                          "updatedAt": "2026-07-28T01:56:11.000Z",
                          "uid": "35240-543a933b-3b13-472c-8a26-ff98180e7f57"
                        }
                      ],
                      "createdAt": "2026-07-28T01:56:11.000Z",
                      "updatedAt": "2026-07-28T01:56:11.000Z",
                      "uid": "35240-a5a5621d-e79a-44b0-a857-4da52b411665"
                    }
                  ],
                  "id": "95decfcf-4049-43ff-98df-c0230f875d98",
                  "createdAt": "2026-07-28T01:56:11.000Z",
                  "updatedAt": "2026-07-28T01:56:11.000Z",
                  "uid": "35240-95decfcf-4049-43ff-98df-c0230f875d98"
                }
              ],
              "id": "cfb53d15-cd21-4ef9-b268-9a939d4fcb66",
              "createdAt": "2026-07-28T01:56:11.000Z",
              "updatedAt": "2026-07-28T01:56:11.000Z",
              "uid": "35240-cfb53d15-cd21-4ef9-b268-9a939d4fcb66"
            }
          ],
          "id": "6ea7950d-f04e-4c6b-adc1-079c400af729",
          "createdAt": "2026-07-28T01:56:11.000Z",
          "updatedAt": "2026-07-28T01:56:11.000Z",
          "uid": "35240-6ea7950d-f04e-4c6b-adc1-079c400af729"
        }
      ],
      "id": "60f0efd6-83ab-4297-859e-7fe2bbade38c",
      "createdAt": "2026-07-28T01:56:11.000Z",
      "updatedAt": "2026-07-28T01:56:11.000Z",
      "uid": "35240-60f0efd6-83ab-4297-859e-7fe2bbade38c"
    }
  ],
  "auth": {
    "type": "oauth2",
    "oauth2": [
      {
        "key": "scope",
        "value": "write:vat read:vat",
        "type": "string"
      },
      {
        "key": "accessTokenUrl",
        "value": "https://api.service.hmrc.gov.uk/oauth/token",
        "type": "string"
      },
      {
        "key": "authUrl",
        "value": "https://api.service.hmrc.gov.uk/oauth/authorize",
        "type": "string"
      },
      {
        "key": "grant_type",
        "value": "authorization_code",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.service.hmrc.gov.uk"
    }
  ]
}