> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idmetagroup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NPWP Details Extraction

> Extract structured fields from an Indonesian NPWP (tax ID) without creating a Trust Validation.



## OpenAPI

````yaml stateless-verification-api/document-ocr/npwp-details-extraction.openapi.json POST /api/v3/verifications/indonesia/npwp-details-extraction-passthrough
openapi: 3.0.3
info:
  title: Document OCR API - NPWP Details Extraction
  version: 1.0.0
servers:
  - url: https://{environment-subdomain}.idmetagroup.com
    description: Your environment (replace `{environment-subdomain}`)
    variables:
      environment-subdomain:
        default: integrate
        description: IDmeta environment subdomain
security:
  - bearerAuth: []
paths:
  /api/v3/verifications/indonesia/npwp-details-extraction-passthrough:
    post:
      tags:
        - Document OCR
      summary: NPWP Details Extraction
      description: >-
        Extract structured fields from an Indonesian NPWP (tax ID) without
        creating a Trust Validation.
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
            example: Bearer {your_api_token}
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - documentImage
              properties:
                documentImage:
                  type: string
                  format: binary
                  description: >-
                    The NPWP image. JPG, JPEG, PNG, or PDF, up to 2 MB. A base64
                    string (raw or `data:` URI) is also accepted.
                metadata:
                  type: object
                  additionalProperties: true
                  description: Optional key-value pairs echoed back in the response.
      responses:
        '200':
          description: >-
            The document was processed. Check `data.outcome` and
            `verificationStatus` to determine the result.
          content:
            application/json:
              examples:
                extracted:
                  summary: extracted — VERIFIED
                  value:
                    success: true
                    message: Indonesia NPWP details extraction processed successfully
                    data:
                      outcome: extracted
                      fields:
                        npwp:
                          value: '092345678901000'
                          confidence: 99.05%
                        name:
                          value: BUDI SANTOSO
                          confidence: 98.60%
                        nik:
                          value: '3174012509870004'
                          confidence: 98.95%
                        address:
                          value: >-
                            JL. MERPATI RAYA NO. 12 RT 003 RW 007, KEBAYORAN
                            LAMA UTARA, JAKARTA SELATAN
                          confidence: 95.20%
                        kpp:
                          value: KPP PRATAMA JAKARTA KEBAYORAN LAMA
                          confidence: 96.75%
                        registrationDate:
                          value: '2012-01-18'
                          confidence: 97.88%
                      missingFields: []
                    verificationStatus: VERIFIED
                    verificationStatusCode: 3
                    transactionId: d3c806f5-41b7-4a92-b8e0-5f1c93a7d268
                    verificationType: npwp_details_extraction
                    metadata: null
                    createdAt: '2026-09-01T05:11:03.000000Z'
                partial:
                  summary: partial — REVIEW_NEEDED
                  value:
                    success: true
                    message: Indonesia NPWP details extraction processed successfully
                    data:
                      outcome: partial
                      fields:
                        npwp: null
                        name:
                          value: BUDI SANTOSO
                          confidence: 98.60%
                        nik:
                          value: '3174012509870004'
                          confidence: 98.95%
                        address:
                          value: >-
                            JL. MERPATI RAYA NO. 12 RT 003 RW 007, KEBAYORAN
                            LAMA UTARA, JAKARTA SELATAN
                          confidence: 95.20%
                        kpp:
                          value: KPP PRATAMA JAKARTA KEBAYORAN LAMA
                          confidence: 96.75%
                        registrationDate:
                          value: '2012-01-18'
                          confidence: 97.88%
                      missingFields:
                        - npwp
                    verificationStatus: REVIEW_NEEDED
                    verificationStatusCode: 2
                    transactionId: d3c806f5-41b7-4a92-b8e0-5f1c93a7d268
                    verificationType: npwp_details_extraction
                    metadata: null
                    createdAt: '2026-09-01T05:11:03.000000Z'
                rejected:
                  summary: rejected — REJECTED
                  value:
                    success: true
                    message: Indonesia NPWP details extraction processed successfully
                    data:
                      outcome: rejected
                      fields:
                        npwp: null
                        name: null
                        nik: null
                        address: null
                        kpp: null
                        registrationDate: null
                      missingFields:
                        - npwp
                        - name
                      errorReason: wrong_document_type
                      errorMessage: The uploaded document does not appear to be a NPWP
                    verificationStatus: REJECTED
                    verificationStatusCode: 1
                    transactionId: d3c806f5-41b7-4a92-b8e0-5f1c93a7d268
                    verificationType: npwp_details_extraction
                    metadata: null
                    createdAt: '2026-09-01T05:11:03.000000Z'
        '400':
          description: The request body or the submitted image failed validation.
          content:
            application/json:
              examples:
                invalidMetadata:
                  summary: metadata not an object
                  value:
                    success: false
                    code: VALIDATION_FAILED
                    message: >-
                      The request could not be validated. Please check the
                      submitted fields.
                    errors:
                      metadata:
                        - The metadata field must be an array.
                    transactionId: null
                    verificationType: npwp_details_extraction
                    createdAt: '2026-09-01T06:06:58.000000Z'
        '500':
          description: >-
            The request could not be processed — either an internal error
            occurred, or the OCR source was unavailable. Check `code` to
            distinguish the two.
          content:
            application/json:
              examples:
                sourceUnavailable:
                  summary: SOURCE_UNAVAILABLE
                  value:
                    success: false
                    code: SOURCE_UNAVAILABLE
                    message: >-
                      Mistral could not process the document (HTTP 422). Note:
                      document annotation supports at most 8 pages.
                    verificationStatus: FAILED
                    verificationStatusCode: 6
                    transactionId: 5d1e97b8-0c46-4a2f-93e5-8f70b6c2a419
                    verificationType: npwp_details_extraction
                    metadata: null
                    createdAt: '2026-09-01T06:27:18.000000Z'
                internalError:
                  summary: INTERNAL_ERROR
                  value:
                    success: false
                    code: INTERNAL_ERROR
                    message: >-
                      An internal error has occurred while processing your
                      request. Please try again later.
                    verificationStatus: FAILED
                    verificationStatusCode: 6
                    transactionId: 5d1e97b8-0c46-4a2f-93e5-8f70b6c2a419
                    verificationType: npwp_details_extraction
                    metadata: null
                    createdAt: '2026-09-01T06:32:07.000000Z'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use your API token as a Bearer token in the `Authorization` header.

````