# VAT for a month or quarter (estimate) (https://docs.getbeel.com/it/api/reference/taxes/getVatPosition)

## GET /companies/me/vat-position

```json

{
  "operationId": "getVatPosition",
  "summary": "VAT for a month or quarter (estimate)",
  "description": "Sales VAT from the issued e-invoices accepted by SDI (credit notes subtract, split payment left out, deferred VAT apart) and an estimate of purchase VAT from reviewed supplier invoices in euros. reliable is always false: deductibility, the month of receipt and reverse charge are not known, so treat it as an estimate to check with the accountant (\"da verificare\"). It is never used for an F24.",
  "tags": [
    "Taxes"
  ],
  "x-required-scope": "taxes:read",
  "parameters": [
    {
      "name": "period",
      "in": "query",
      "required": true,
      "description": "A month (2026-10) or a quarter (2026-Q3)",
      "schema": {
        "type": "string",
        "pattern": "^\\d{4}-(Q[1-4]|0[1-9]|1[0-2])$",
        "examples": [
          "2026-Q3",
          "2026-10"
        ]
      }
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/VatPosition"
          }
        }
      }
    },
    "400": {
      "description": "Invalid request",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "401": {
      "description": "Missing, invalid, revoked or expired API key",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "403": {
      "description": "The key lacks the 'taxes:read' scope",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "429": {
      "description": "Rate limit exceeded; see Retry-After",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "500": {
      "description": "Server error; quote X-Request-Id",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}

```

Full OpenAPI document: https://docs.getbeel.com/openapi.json