> ## 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.

# Income Verification Passthrough

> Estimate income using the Indonesian income verification passthrough endpoint.



## OpenAPI

````yaml stateless-verification-api/indonesia-government/indonesia-passthrough.openapi.json POST /api/v3/verifications/indonesia/income-verification-passthrough
openapi: 3.0.3
info:
  title: Indonesia Government Passthrough API
  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/income-verification-passthrough:
    post:
      tags:
        - Indonesia Government Verification
      summary: Income Verification
      description: >-
        Estimate income using the Indonesian income verification source. The
        request requires a 16-digit NIK.
      operationId: indonesiaIncomePassthrough
      requestBody:
        $ref: '#/components/requestBodies/IncomeRequestBody'
      responses:
        '200':
          $ref: '#/components/responses/SuccessIncome'
        '400':
          $ref: '#/components/responses/ValidationError'
        '500':
          $ref: '#/components/responses/SourceError'
components:
  requestBodies:
    IncomeRequestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IncomeRequest'
  responses:
    SuccessIncome:
      description: >-
        The source returned a completed verified or rejected result. Both
        outcomes use HTTP 200.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SuccessResponse'
          examples:
            completed:
              $ref: '#/components/examples/IncomeSuccess'
    ValidationError:
      description: >-
        The request failed validation. No source lookup is performed and
        `transactionId` is null.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationErrorResponse'
          examples:
            invalidRequest:
              $ref: '#/components/examples/ValidationFailure'
    SourceError:
      description: >-
        The Indonesian source was unavailable, returned an unusable response, or
        an internal processing failure occurred.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SourceErrorResponse'
          examples:
            sourceUnavailable:
              $ref: '#/components/examples/SourceFailure'
            internalError:
              $ref: '#/components/examples/InternalFailure'
  schemas:
    IncomeRequest:
      type: object
      required:
        - nik
      properties:
        nik:
          type: string
          pattern: ^[0-9]{16}$
          description: 16-digit Indonesian national identity number.
          example: '0000000000000000'
        metadata:
          $ref: '#/components/schemas/Metadata'
    SuccessResponse:
      type: object
      required:
        - success
        - message
        - data
        - verificationStatus
        - verificationStatusCode
        - transactionId
        - verificationType
        - createdAt
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
        data:
          type: object
          additionalProperties: true
          description: >-
            CamelCase result fields from the corresponding Indonesia v3
            verification.
        verificationStatus:
          type: string
          enum:
            - VERIFIED
            - REJECTED
        verificationStatusCode:
          type: integer
          enum:
            - 3
            - 1
          description: '`3` = Verified, `1` = Rejected.'
        transactionId:
          type: string
          format: uuid
        verificationType:
          type: string
        metadata:
          $ref: '#/components/schemas/Metadata'
          nullable: true
        createdAt:
          type: string
          example: 2026-09-02 08:00:00+0000
    ValidationErrorResponse:
      type: object
      required:
        - success
        - code
        - message
        - errors
        - transactionId
        - verificationType
        - createdAt
      properties:
        success:
          type: boolean
          example: false
        code:
          type: string
          enum:
            - VALIDATION_FAILED
        message:
          type: string
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
        transactionId:
          type: string
          format: uuid
          nullable: true
        verificationType:
          type: string
        createdAt:
          type: string
    SourceErrorResponse:
      type: object
      required:
        - success
        - code
        - message
        - verificationStatus
        - verificationStatusCode
        - transactionId
        - verificationType
        - createdAt
      properties:
        success:
          type: boolean
          example: false
        code:
          type: string
          enum:
            - IDN_GOV_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
        verificationStatus:
          type: string
          example: FAILED
        verificationStatusCode:
          type: integer
          example: 6
        transactionId:
          type: string
          format: uuid
        verificationType:
          type: string
        metadata:
          $ref: '#/components/schemas/Metadata'
          nullable: true
        createdAt:
          type: string
    Metadata:
      type: object
      additionalProperties: true
      description: >-
        Optional client-defined values echoed in completed and source-error
        responses.
  examples:
    IncomeSuccess:
      summary: Income result
      value:
        success: true
        message: Indonesia income verification processed successfully
        data:
          isValid: true
          result: success
          incomeRange: example-range
        verificationStatus: VERIFIED
        verificationStatusCode: 3
        transactionId: 79b6f81c-fc48-42ce-b907-763129b0957e
        verificationType: idn_income_verification
        metadata:
          yourRef: case-example
        createdAt: 2026-09-02 08:00:00+0000
    ValidationFailure:
      summary: Validation failed
      value:
        success: false
        code: VALIDATION_FAILED
        message: The request could not be validated. Please check the submitted fields.
        errors:
          nik:
            - The nik field is required.
        transactionId: null
        verificationType: dukcapil
        createdAt: 2026-09-02 08:00:00+0000
    SourceFailure:
      summary: Indonesia source unavailable
      value:
        success: false
        code: IDN_GOV_UNAVAILABLE
        message: >-
          The Indonesian verification source is currently unavailable. Please
          try again later.
        verificationStatus: FAILED
        verificationStatusCode: 6
        transactionId: f43156f1-c11c-4a38-92d9-c2d3221eba5b
        verificationType: idn_income_verification
        metadata:
          yourRef: case-example
        createdAt: 2026-09-02 08:00:00+0000
    InternalFailure:
      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: f43156f1-c11c-4a38-92d9-c2d3221eba5b
        verificationType: idn_income_verification
        metadata:
          yourRef: case-example
        createdAt: 2026-09-02 08:00:00+0000
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use your API token as a Bearer token in the `Authorization` header.

````