VAT Codes

VAT codes define tax rates and the ledger routing applied to sales and purchases. Use this query to read the codes available to your organization so you can attach the correct VAT to invoices, purchases, subscriptions, and bank reconciliation.

Prerequisites

• A Naqood API secret or OAuth-issued secret scoped to the organization
• The organization slug on every request
• A role that can view organization settings

VAT fields

Field	Type	Notes
id	ID!	Stable identifier for the VAT code
code	String!	Short code shown in the UI (for example SR-5)
name	String!	Display name
rate	Int!	Rate as an integer percentage (for example 5 means 5%)
description	String!	Purpose or applicability

List VAT codes

Fetch VAT codes for an organization.

query VatCodes($slug: Slug!) {
  organization(slug: $slug) {
    vats {
      id
      code
      name
      rate
      description
    }
  }
}

Use the returned IDs when creating or updating documents that support VAT (for example vatId on purchase lines). VAT configuration (creating or editing codes) is managed in the Naqood UI; the API currently exposes read-only access.