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

# Answer a request for information

> When the review needs more (`requirements` lists it, after the Child org went to review), upload each document it names first, with the document upload. Then send this request: a new identity document in `identity_documents` when `requirements` lists an `identity_document.*` field, and `terms_value` when it lists `terms_value`. Only what `requirements` lists is sent for review.



## OpenAPI

````yaml /v2/openapi.json post /child-orgs/{id}/information
openapi: 3.1.0
info:
  title: Jenzy Hermes Multi-asset API
  version: 2.0.0
  description: >-
    Hold and pay out across the assets enabled for your organization. Every
    amount is an exact decimal string beside an `asset` field. Authenticate with
    the same `jz_live_…` API key as `/v1`.
servers:
  - url: https://api.jenzy.com/v2
    description: Production
security: []
paths:
  /child-orgs/{id}/information:
    post:
      summary: Answer a request for information
      description: >-
        When the review needs more (`requirements` lists it, after the Child org
        went to review), upload each document it names first, with the document
        upload. Then send this request: a new identity document in
        `identity_documents` when `requirements` lists an `identity_document.*`
        field, and `terms_value` when it lists `terms_value`. Only what
        `requirements` lists is sent for review.
      parameters:
        - schema:
            type: string
            description: The Child org id (UUID).
          required: true
          description: The Child org id (UUID).
          name: id
          in: path
        - $ref: '#/components/parameters/HermesOrg'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChildOrgInformation'
      responses:
        '200':
          description: The Child org, with its new `status` and `requirements`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChildOrg'
        '400':
          description: >-
            `validation_error`: the body is not valid, or a listed item is not
            answered (the message names it).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Missing, malformed, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: >-
            Organization suspended, request IP not on the allowlist, or no
            multi-asset access yet (`onboarding_incomplete` /
            `access_suspended`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: No Child org with this id under your organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: >-
            `conflict`: nothing is requested now, the Child org is not in review
            yet, or an item must be answered by Jenzy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '503':
          description: The `/v2` shutter is closed — check `GET /v2/ping`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - ApiKeyAuth: []
components:
  parameters:
    HermesOrg:
      name: HERMES-ORG
      in: header
      required: false
      description: >-
        The id of one of your Child orgs. The call then acts on that Child org,
        not on your organization. If you do not send it, the call acts on your
        organization. An id that is not one of your Child orgs gives `404`.
      schema:
        type: string
        format: uuid
        example: 3f1c2a9e-8b7d-4e21-9a6f-0c5d4b3e2a10
  schemas:
    ChildOrgInformation:
      type: object
      properties:
        identity_documents:
          type: array
          items:
            type: object
            properties:
              party_id:
                type:
                  - string
                  - 'null'
                format: uuid
                default: null
                description: >-
                  The associated party whose document it is; null for the Child
                  org itself.
              type:
                type: string
                enum:
                  - passport
                  - national_id
                  - drivers_license
                  - residence_permit
                description: >-
                  Upload this type later. `national_id`, `drivers_license` and
                  `residence_permit` need a front and a back.
              number:
                type: string
                minLength: 1
              country:
                type: string
                description: ISO 3166-1 alpha-2.
                example: DE
              issue_date:
                type: string
                format: date
                description: '`YYYY-MM-DD`.'
                example: '1982-03-24'
              expiry_date:
                type: string
                format: date
                description: '`YYYY-MM-DD`.'
                example: '1982-03-24'
            required:
              - type
              - number
              - country
              - issue_date
              - expiry_date
            additionalProperties: false
          minItems: 1
          description: >-
            A new identity document, when `requirements` lists an
            `identity_document.*` field. Upload its file with the same `type`
            first.
        terms_value:
          type: string
          minLength: 1
          description: When `requirements` lists `terms_value`.
      additionalProperties: false
    ChildOrg:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The Child org id.
        type:
          type: string
          enum:
            - individual
            - business
        display_name:
          type: string
        reference:
          type:
            - string
            - 'null'
        status:
          type: string
          enum:
            - incomplete
            - in_review
            - action_required
            - active
            - rejected
            - suspended
          description: >-
            `incomplete`: `requirements` lists what you still owe before review.
            `in_review`: nothing is owed; the review is in progress.
            `action_required`: the review needs more from you; `requirements`
            lists it, and you send it with `POST
            /v2/child-orgs/{id}/information`. `active`: approved; the Child org
            can transact. `requirements` can list a request after approval; the
            status stays `active`. `rejected`: final; to try again, create a new
            Child org. `suspended`: the Child org or your organization is
            suspended.
        requirements:
          type: array
          items:
            $ref: '#/components/schemas/ChildOrgRequirement'
        capabilities:
          type: object
          properties:
            usd_collections:
              type: string
              enum:
                - pending
                - active
                - unavailable
            usd_payouts:
              type: string
              enum:
                - pending
                - active
                - unavailable
          required:
            - usd_collections
            - usd_payouts
        associated_parties:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
            required:
              - id
          description: >-
            A business’s associated parties, in the order you sent them. Name a
            party’s `id` when you upload its documents.
        terms_url:
          type:
            - string
            - 'null'
          description: >-
            The terms page to show your customer. After your customer accepts,
            send `terms_value`. Null after you send it.
        created_at:
          type: string
          format: date-time
      required:
        - id
        - type
        - display_name
        - reference
        - status
        - requirements
        - capabilities
        - associated_parties
        - terms_url
        - created_at
    ErrorEnvelope:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_error
                - unauthorized
                - forbidden
                - not_found
                - conflict
                - rate_limited
                - internal_error
                - unknown_institution
                - invalid_mobile_number
                - invalid_account_number
                - mobile_number_institution_mismatch
                - service_unavailable
                - sandbox_only
                - insufficient_funds
                - rail_disabled
                - amount_limit_exceeded
                - org_limit_exceeded
                - service_incident
                - service_maintenance
                - onboarding_incomplete
                - access_suspended
                - corridor_not_enabled
                - unsupported_pair
                - invalid_wallet_address
                - rate_unavailable
                - quote_expired
                - quote_used
                - limit_exceeded
                - amount_below_minimum
                - unsupported_asset
                - unsupported_network
                - unsupported_media_type
                - payload_too_large
                - client_ref_used
                - beneficiary_required
                - beneficiary_not_allowed
                - proof_not_expected
                - invalid_beneficiary
                - beneficiary_exists
                - beneficiary_not_active
                - invoice_required
                - prohibited_industry
              description: >-
                Stable identifier a client may branch on — never renamed or
                removed.
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
    ChildOrgRequirement:
      type: object
      properties:
        party_id:
          type:
            - string
            - 'null'
          format: uuid
          description: The associated party that owes it; null for the Child org itself.
        field:
          type:
            - string
            - 'null'
          description: >-
            A detail that is owed, e.g. `terms_value` or
            `identity_document.expiry_date`. Null for a document.
          example: terms_value
        document_category:
          type:
            - string
            - 'null'
          description: The category of document that is owed. Null for a detail.
          example: identifying_documents
        document_types:
          type: array
          items:
            type: string
          description: 'The document `type`s that satisfy it: one of them is enough.'
          example:
            - passport
            - national_id
        reason:
          type: string
          enum:
            - missing
            - expired
            - invalid
      required:
        - party_id
        - field
        - document_category
        - document_types
        - reason
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: 'Your Jenzy API key: `Authorization: Bearer jz_live_…`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.