> ## Documentation Index
> Fetch the complete documentation index at: https://humanity-eaeda8f6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Presets · Batch verification

<Callout>
  **SDK equivalent**

  ```ts theme={null}
  const batch = await sdk.verifyPresets(['is_human', 'is_21_plus'], accessToken);
  ```
</Callout>

Send one or more preset keys (for example `is_human`, `is_21_plus`, `humanity_user`) to receive the latest verdict, evidence payload, and expiration metadata for each.

* Include `presets[].name` + optional `presets[].value` when requesting dynamic checks.
* Responses return `results[]` with `status` (`valid`, `expired`, `pending`, `unavailable`) plus timestamps.
* Use the SDK helper `verifyPresets` for a typed wrapper around this endpoint.


## OpenAPI

````yaml api-reference/openapi.json post /presets/batch
openapi: 3.1.0
info:
  version: 0.1.0
  title: hp-public-dev-api-server
  description: NestJS CQRS + TDD base for Humanity Public Dev API
servers:
  - url: https://api.sandbox.humanity.org/v2
    description: Sandbox environment for development and testing
  - url: https://api.humanity.org/v2
    description: Production environment
security: []
tags: []
paths:
  /presets/batch:
    post:
      tags: []
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyPresetsRequest'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyPresetsResponse'
components:
  schemas:
    VerifyPresetsRequest:
      type: object
      properties:
        presets:
          type: array
          items:
            oneOf:
              - const: humanity_uuid
              - const: humanity_score
              - const: is_human
              - const: country_of_residence
              - const: age
              - const: address_postal_code
              - const: legal_name
              - const: residency_region
              - const: age_over_18
              - const: nationality
              - const: address_full
              - const: date_of_birth
              - const: email
              - const: phone
              - const: age_over_21
              - const: social_accounts
              - const: wallet_address
              - const: primary_wallet_address
              - const: kyc_passed
              - const: kyc_last_updated_at
              - const: document_number
              - const: document_country
              - const: document_expiry_date
              - const: net_worth_above_10k
              - const: net_worth_above_100k
              - const: net_worth_total
              - const: bank_balance_total
              - const: loan_balance_total
              - const: google_connected
              - const: linkedin_connected
              - const: facebook_connected
              - const: twitter_connected
              - const: discord_connected
              - const: github_connected
              - const: telegram_connected
              - const: palm_verified
              - const: humanity_user
              - const: proof_of_assets
              - const: proof_of_investments
              - const: proof_of_mortgage
              - const: proof_of_residency
              - const: proof_of_retirement
      required:
        - presets
    VerifyPresetsResponse:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/PresetResult'
        errors:
          type: array
          items:
            type: object
            properties:
              preset:
                oneOf:
                  - const: humanity_uuid
                  - const: humanity_score
                  - const: is_human
                  - const: country_of_residence
                  - const: age
                  - const: address_postal_code
                  - const: legal_name
                  - const: residency_region
                  - const: age_over_18
                  - const: nationality
                  - const: address_full
                  - const: date_of_birth
                  - const: email
                  - const: phone
                  - const: age_over_21
                  - const: social_accounts
                  - const: wallet_address
                  - const: primary_wallet_address
                  - const: kyc_passed
                  - const: kyc_last_updated_at
                  - const: document_number
                  - const: document_country
                  - const: document_expiry_date
                  - const: net_worth_above_10k
                  - const: net_worth_above_100k
                  - const: net_worth_total
                  - const: bank_balance_total
                  - const: loan_balance_total
                  - const: google_connected
                  - const: linkedin_connected
                  - const: facebook_connected
                  - const: twitter_connected
                  - const: discord_connected
                  - const: github_connected
                  - const: telegram_connected
                  - const: palm_verified
                  - const: humanity_user
                  - const: proof_of_assets
                  - const: proof_of_investments
                  - const: proof_of_mortgage
                  - const: proof_of_residency
                  - const: proof_of_retirement
              error:
                $ref: '#/components/schemas/PresetError'
            required:
              - preset
              - error
      required:
        - results
        - errors
    PresetResult:
      type: object
      properties:
        preset:
          oneOf:
            - const: humanity_uuid
            - const: humanity_score
            - const: is_human
            - const: country_of_residence
            - const: age
            - const: address_postal_code
            - const: legal_name
            - const: residency_region
            - const: age_over_18
            - const: nationality
            - const: address_full
            - const: date_of_birth
            - const: email
            - const: phone
            - const: age_over_21
            - const: social_accounts
            - const: wallet_address
            - const: primary_wallet_address
            - const: kyc_passed
            - const: kyc_last_updated_at
            - const: document_number
            - const: document_country
            - const: document_expiry_date
            - const: net_worth_above_10k
            - const: net_worth_above_100k
            - const: net_worth_total
            - const: bank_balance_total
            - const: loan_balance_total
            - const: google_connected
            - const: linkedin_connected
            - const: facebook_connected
            - const: twitter_connected
            - const: discord_connected
            - const: github_connected
            - const: telegram_connected
            - const: palm_verified
            - const: humanity_user
            - const: proof_of_assets
            - const: proof_of_investments
            - const: proof_of_mortgage
            - const: proof_of_residency
            - const: proof_of_retirement
        value: {}
        status:
          oneOf:
            - const: valid
            - const: expired
            - const: pending
            - const: unavailable
        expires_at:
          type: string
        verified_at:
          type: string
        evidence:
          $ref: '#/components/schemas/Recordstringunknown.o1'
      required:
        - preset
        - value
        - status
        - expires_at
    PresetError:
      type: object
      properties:
        error:
          type: string
        error_code:
          oneOf:
            - const: E4003
              description: >-
                Insufficient scope for the requested preset data; see Appendix J
                Error Codes (E4003) and Appendix O Advanced Consent Management
                (revoked scopes).
            - const: E4004
              description: >-
                Preset is unavailable because verification is pending, revoked,
                or incomplete; documented in Appendix J Error Codes (E4004) and
                Appendix D Developer Flows.
            - const: E4010
              description: >-
                Cached preset data has expired and requires reauthorization;
                described in Appendix B API Reference preset expiration
                response.
            - const: E4041
              description: >-
                OAuth access token is expired; covered in Appendix J Error Codes
                (E4041 Token Expired).
            - const: E4042
              description: >-
                OAuth access token is invalid due to revocation, mismatch, or
                signature issues; detailed in Appendix J Error Codes (E4042
                Invalid Token).
            - const: E4044
              description: >-
                Requested preset resource cannot be found; specified in Appendix
                J Error Codes (E4044 Not Found).
        error_description:
          type: string
        error_subcode:
          type: string
        context:
          $ref: '#/components/schemas/Recordstringstringnumberbooleanstringnull'
      required:
        - error
        - error_code
        - error_description
    Recordstringunknown.o1:
      type: object
      properties: {}
      required: []
      description: Construct a type with a set of properties K of type T
      additionalProperties: {}
    Recordstringstringnumberbooleanstringnull:
      type: object
      properties: {}
      required: []
      description: Construct a type with a set of properties K of type T
      additionalProperties:
        oneOf:
          - type: 'null'
          - type: string
          - type: number
          - type: boolean
          - type: array
            items:
              type: string

````