---
updatedAt: 2026-08-07T08:07:30.000Z
agentTools:
  projectIndex: https://docs.verihubs.com/llms.txt
---

# Tax Number NPWP Endpoint

This method helps you to check tax identifier. Please check Verihubs Guidelines to learn more on how to use this endpoint.


# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "servers": [
    {
      "url": "https://api.verihubs.com/"
    }
  ],
  "info": {
    "title": "Data API Documentation",
    "version": "2.0.0"
  },
  "tags": [
    {
      "name": "Tax Number Verification",
      "description": "Check the registered status of the associated NPWP based on NIK or NPWP."
    }
  ],
  "paths": {
    "/data-verification/tax/npwp/verify": {
      "post": {
        "tags": [
          "Tax Number Verification"
        ],
        "summary": "Tax Number NPWP Endpoint",
        "description": "This method helps you to check tax identifier. Please check Verihubs Guidelines to learn more on how to use this endpoint.\n",
        "operationId": "post_tax_npwp_check",
        "parameters": [
          {
            "required": true,
            "schema": {
              "title": "App-ID",
              "type": "string"
            },
            "name": "App-ID",
            "in": "header"
          },
          {
            "required": true,
            "schema": {
              "title": "API-Key",
              "type": "string"
            },
            "name": "API-Key",
            "in": "header"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/taxnpwpcheck"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseTaxNPWPCheck200"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseTaxNPWPSend400"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseTaxNPWPSend401"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseTaxNPWPSend403"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseTaxNPWPSend429"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseTaxNPWPSend500"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "taxnpwpcheck": {
        "title": "post_tax_npwp_check",
        "type": "object",
        "required": [
          "npwp",
          "purpose"
        ],
        "properties": {
          "npwp": {
            "description": "16 digits number from NPWP card, if it's a 15 digit number, add 0 before the first number to make it 16 digits.",
            "type": "string",
            "example": "327135756xxxxxxx"
          },
          "purpose": {
            "description": "Purpose of doing the verification.",
            "type": "string",
            "example": "Check personal npwp"
          },
          "reference_id": {
            "description": "This reference_id can be used to indicate your company’s transaction (must be unique per transaction).",
            "type": "string",
            "example": "Testing-001"
          }
        }
      },
      "ResponseTaxNPWPCheck200": {
        "title": "posttaxnpwpcheck",
        "required": [
          "message",
          "id",
          "reference_id",
          "npwp",
          "nama",
          "alamat",
          "status_wp",
          "status_spt"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Successfully check NPWP."
          },
          "data": {
            "description": "Shows result of NPWP Verification",
            "type": "object",
            "properties": {
              "id": {
                "description": "id",
                "type": "string",
                "example": "238fc15d-5f3c-4a72-8d59-63bd8d4288e2"
              },
              "reference_id": {
                "description": "reference_id",
                "type": "string",
                "example": "ref_tax#72708413-4bd5-4d2e-982f-da9d7085b010"
              },
              "name": {
                "description": "name of the tax identifier",
                "type": "string",
                "example": "J*hn D**"
              },
              "alamat": {
                "description": "address in the tax identifier",
                "type": "string",
                "example": "J*k*rt* B*r*t"
              },
              "status_wp": {
                "description": "status of Wajib Pajak",
                "type": "string",
                "example": "AKTIF"
              },
              "status_spt": {
                "description": "status of SPT",
                "type": "string",
                "example": "VALID"
              }
            }
          }
        }
      },
      "ResponseTaxNPWPSend400": {
        "title": "Bad Request",
        "required": [
          "message",
          "error_code",
          "error_fields"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Invalid Payload"
          },
          "error_code": {
            "description": "Error Code",
            "type": "string",
            "example": "INVALID_PAYLOAD"
          },
          "error_fields": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            }
          }
        }
      },
      "ResponseTaxNPWPSend401": {
        "title": "Authorization Failed",
        "required": [
          "message",
          "error_code",
          "error_fields"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Authorization Failed"
          },
          "error_code": {
            "description": "Error Code",
            "type": "string",
            "example": "UNAUTHORIZED"
          },
          "error_fields": {
            "description": "Error Fields",
            "type": "object"
          }
        }
      },
      "ResponseTaxNPWPSend403": {
        "title": "Quota Insufficient",
        "required": [
          "message",
          "error_code",
          "error_fields"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Insufficient Testing Quota"
          },
          "error_code": {
            "description": "Error Code",
            "type": "string",
            "example": "FORBIDDEN"
          },
          "error_fields": {
            "description": "Error Fields",
            "type": "object"
          }
        }
      },
      "ResponseTaxNPWPSend429": {
        "title": "Spam Error",
        "required": [
          "message",
          "error_code",
          "error_fields"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Too Many Request in allowed time frame"
          },
          "error_code": {
            "description": "Error Code",
            "type": "string",
            "example": "TOO_MANY_REQUEST"
          },
          "error_fields": {
            "description": "Error Fields",
            "type": "object"
          }
        }
      },
      "ResponseTaxNPWPSend500": {
        "title": "Internal Server Error",
        "required": [
          "message",
          "error_code",
          "error_fields"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Internal Server Error"
          },
          "error_code": {
            "description": "Error Code",
            "type": "string",
            "example": "INTERNAL_SERVER_ERROR"
          },
          "error_fields": {
            "description": "Error Fields",
            "type": "object"
          }
        }
      }
    }
  }
}
```