> ## Documentation Index > Fetch the complete documentation index at: https://docs.mnai.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an Information Request by ID > Returns the Information Request details for the authenticated Meridian account. ## OpenAPI ````yaml /products/meridian-accounts/api-reference/meridian-accounts.json get /v1/information-requests/{informationRequestId} openapi: 3.1.1 info: title: Meridian API version: '1.0' description: API documentation for Meridian services contact: name: Meridian url: https://mnai.com email: support@mnai.com license: name: Proprietary url: https://mnai.com servers: - url: https://sandbox-api.va.meridianpay.com description: Sandbox - url: https://api.va.mnai.com description: Production security: [] paths: /v1/information-requests/{informationRequestId}: get: tags: - Information Requests summary: Get an Information Request by ID description: >- Returns the Information Request details for the authenticated Meridian account. operationId: getInformationRequest parameters: - name: Authorization in: header description: >- Bearer authentication header of the form `Bearer {token}`. Required for client-server (JWT) authentication. See [Authentication](/products/meridian-accounts/guides/authentication-overview). schema: type: string - name: X-Meridian-Program-Id in: header description: >- Identifies the program context for the request. Required for server-to-server (HMAC) authentication. See [Authentication](/products/meridian-accounts/guides/authentication-overview). schema: type: string - name: X-Meridian-User-Id in: header description: >- Identifies the Meridian user targeted by the request. Required for server-to-server (HMAC) authentication with MULTI_USER integrations; omit for SINGLE_USER. See [Authentication](/products/meridian-accounts/guides/authentication-overview). schema: type: string - name: X-Meridian-Api-Key in: header description: >- Partner API key issued by Meridian during provisioning. Required for server-to-server (HMAC) authentication. See [Authentication](/products/meridian-accounts/guides/authentication-overview). schema: type: string - name: X-Meridian-Timestamp in: header description: >- Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request. Required for server-to-server (HMAC) authentication. See [Authentication](/products/meridian-accounts/guides/authentication-overview). schema: type: string - name: X-Meridian-Signature in: header description: >- HMAC SHA-256 signature of the canonical request string, computed per request. Required for server-to-server (HMAC) authentication. See [Authentication](/products/meridian-accounts/guides/authentication-overview) for how to construct it. schema: type: string - name: informationRequestId in: path required: true schema: type: string responses: '200': description: The Information Request details for the authenticated account content: application/json: schema: $ref: '#/components/schemas/Information Request Detail Response' examples: associated_persons_identity_passport: $ref: >- #/components/examples/GetInformationRequestAssociatedPersonsPassport associated_persons_identity_drivers_license: $ref: >- #/components/examples/GetInformationRequestAssociatedPersonsDriversLicense '401': description: Missing or invalid authentication content: application/json: schema: $ref: '#/components/schemas/MeridianError' '403': description: >- The authenticated caller is not permitted: JWT scope missing, or the partner API key lacks entitlement, user ownership, or user-type match content: application/json: schema: $ref: '#/components/schemas/MeridianError' '404': description: The requested Information Request was not found content: application/json: schema: $ref: '#/components/schemas/MeridianError' security: - meridian-account-jwt: [] - partner-api-key: [] components: schemas: Information Request Detail Response: type: object title: Information Request Detail Response description: >- Detailed Information Request payload for the authenticated Meridian account required: - id - status - subjectType - subjectId - requirements - validationStatus - createdAt - updatedAt properties: id: type: string description: Unique identifier of the Information Request example: ir_01HZX1A2B3C4D5E6F7G8H9J0K status: type: string description: Current status of the Information Request example: DRAFT enum: - DRAFT - PROCESSING_SUBMISSION - PENDING_REVIEW - COMPLETED - CANCELED subjectType: type: string description: Type of entity the Information Request is associated with example: ENROLLMENT enum: - ENROLLMENT subjectId: type: string description: Identifier of the entity the Information Request is associated with example: enrollment_123 requirements: type: array description: >- Requirement contracts and submitted entries for this Information Request items: $ref: '#/components/schemas/Information Request Requirement' validationStatus: type: string description: Validation status of the Information Request data example: MISSING enum: - MISSING - VALID - INVALID decision: type: - string - 'null' description: >- Current manual review decision status for the Information Request, if it has been reviewed example: PENDING enum: - PENDING - APPROVED - REJECTED title: type: - string - 'null' description: Display title for the Information Request example: Business Verification createdAt: type: string description: Timestamp when the Information Request was created example: '2026-04-01T12:00:00Z' format: date-time updatedAt: type: string description: Timestamp when the Information Request was last updated example: '2026-04-01T12:05:00Z' format: date-time MeridianError: type: object title: com.meridianpay.core.common.api.MeridianError description: >- Represents an error response from the Meridian API, including validation errors and an optional error code. required: - message properties: validationErrors: type: array description: >- An array of validation errors that occurred during the processing of the request. This field is optional and may be empty if there are no validation errors. items: $ref: '#/components/schemas/ValidationError' errorCode: type: - string - 'null' description: >- An optional error code that provides additional information about the error. This field is optional and may be null. message: type: string description: >- A human-readable message describing the error. This field is required and should provide a clear explanation of the error that occurred. Information Request Requirement: type: object title: Information Request Requirement description: Requirement contract and submitted entries required: - requirementKey - cardinality - documents - validationStatus - entries properties: requirementKey: type: string description: Stable requirement key example: business_information title: type: - string - 'null' description: Display title for the requirement description: type: - string - 'null' description: Display description for the requirement cardinality: $ref: '#/components/schemas/Information Request Requirement Cardinality' dataSchema: type: - object - 'null' description: JSON Schema describing the expected structured data shape documents: type: array description: Document slots that may be attached to each entry items: $ref: '#/components/schemas/MeridianInformationRequestDocumentDefinition' validationStatus: type: string description: Validation status of this requirement enum: - MISSING - VALID - INVALID entries: type: array description: Submitted entries for this requirement items: $ref: '#/components/schemas/MeridianInformationRequestEntry' ValidationError: type: object title: com.meridianpay.core.common.api.ValidationError description: >- Represents a validation error that occurred during the processing of a request to the Meridian API. One of the following types of validation errors may be present: InvalidFormat, InvalidValue, MissingValue, UnprocessableValue, UnexpectedVerificationError, MissingRequestBody, MissingPathParameter, MissingQueryParameter, or NotFound. Each validation error includes a reference to the field that caused the error and a message describing the error. oneOf: - $ref: '#/components/schemas/InvalidFormat' - $ref: '#/components/schemas/InvalidValue' - $ref: '#/components/schemas/MissingPathParameter' - $ref: '#/components/schemas/MissingQueryParameter' - $ref: '#/components/schemas/MissingRequestBody' - $ref: '#/components/schemas/MissingValue' - $ref: '#/components/schemas/NotFound' - $ref: '#/components/schemas/UnexpectedVerificationError' - $ref: '#/components/schemas/UnprocessableValue' discriminator: propertyName: type mapping: com.meridianpay.core.common.api.ValidationError.InvalidFormat: $ref: '#/components/schemas/InvalidFormat' com.meridianpay.core.common.api.ValidationError.InvalidValue: $ref: '#/components/schemas/InvalidValue' com.meridianpay.core.common.api.ValidationError.MissingPathParameter: $ref: '#/components/schemas/MissingPathParameter' com.meridianpay.core.common.api.ValidationError.MissingQueryParameter: $ref: '#/components/schemas/MissingQueryParameter' com.meridianpay.core.common.api.ValidationError.MissingRequestBody: $ref: '#/components/schemas/MissingRequestBody' com.meridianpay.core.common.api.ValidationError.MissingValue: $ref: '#/components/schemas/MissingValue' com.meridianpay.core.common.api.ValidationError.NotFound: $ref: '#/components/schemas/NotFound' com.meridianpay.core.common.api.ValidationError.UnexpectedVerificationError: $ref: '#/components/schemas/UnexpectedVerificationError' com.meridianpay.core.common.api.ValidationError.UnprocessableValue: $ref: '#/components/schemas/UnprocessableValue' Information Request Requirement Cardinality: type: object title: Information Request Requirement Cardinality description: Requirement cardinality required: - mode - min properties: mode: type: string description: >- Cardinality mode for the requirement. SINGLE means exactly one entry is expected; MULTIPLE means the requirement may accept more than one entry. example: SINGLE min: type: integer description: Minimum number of entries required for this requirement example: 1 max: type: - integer - 'null' description: >- Maximum number of entries allowed for this requirement. Null means there is no fixed upper limit. example: 1 MeridianInformationRequestDocumentDefinition: type: object title: >- com.meridianpay.remittances.api.dto.meridian.MeridianInformationRequestDocumentDefinition description: Requirement document slot required: - documentKey - minFiles - maxFiles - supportedMimeTypes - maxFileSizeBytes properties: documentKey: type: string description: Stable document key example: identityDocumentFront minFiles: type: integer maxFiles: type: integer supportedMimeTypes: type: array items: type: string maxFileSizeBytes: type: integer MeridianInformationRequestEntry: type: object title: >- com.meridianpay.remittances.api.dto.meridian.MeridianInformationRequestEntry description: Submitted requirement entry required: - entryId - validationStatus - documents properties: entryId: type: string clientReferenceId: type: - string - 'null' validationStatus: type: string enum: - MISSING - VALID - INVALID data: type: - object - 'null' documents: type: array items: $ref: '#/components/schemas/MeridianInformationRequestEntryDocument' InvalidFormat: type: object title: com.meridianpay.core.common.api.ValidationError.InvalidFormat description: The provided value exists, but its format is invalid for the field. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. InvalidValue: type: object title: com.meridianpay.core.common.api.ValidationError.InvalidValue description: >- The provided value is syntactically valid, but not accepted for the field. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. MissingPathParameter: type: object title: com.meridianpay.core.common.api.ValidationError.MissingPathParameter description: A required path parameter was not supplied. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. MissingQueryParameter: type: object title: com.meridianpay.core.common.api.ValidationError.MissingQueryParameter description: A required query parameter was not supplied. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. MissingRequestBody: type: object title: com.meridianpay.core.common.api.ValidationError.MissingRequestBody description: >- The request body is missing or does not contain the required non-null fields. properties: message: type: string description: A human-readable explanation of the validation failure. fieldRef: type: string MissingValue: type: object title: com.meridianpay.core.common.api.ValidationError.MissingValue description: A required value for the field was not provided. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. NotFound: type: object title: com.meridianpay.core.common.api.ValidationError.NotFound description: The referenced principal object was not found. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. UnexpectedVerificationError: type: object title: >- com.meridianpay.core.common.api.ValidationError.UnexpectedVerificationError description: A downstream verification step failed while checking the value. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. UnprocessableValue: type: object title: com.meridianpay.core.common.api.ValidationError.UnprocessableValue description: The provided value cannot be processed into a valid result. required: - fieldRef properties: fieldRef: type: string description: The field or parameter that triggered the validation error. message: type: string description: A human-readable explanation of the validation failure. MeridianInformationRequestEntryDocument: type: object title: >- com.meridianpay.remittances.api.dto.meridian.MeridianInformationRequestEntryDocument description: Files attached to one requirement document slot required: - documentKey - files properties: documentKey: type: string files: type: array items: $ref: '#/components/schemas/Information Request Uploaded File' Information Request Uploaded File: type: object title: Information Request Uploaded File description: An uploaded file associated with an Information Request document required: - fileName - mimeType - sizeBytes - storageKey properties: fileName: type: string description: Original file name of the uploaded file example: business_license.pdf mimeType: type: string description: MIME type of the uploaded file example: application/pdf sizeBytes: type: integer description: File size in bytes example: 204800 storageKey: type: string description: Storage key used to retrieve the uploaded file example: >- uploads/ir_01HZX1A2B3C4D5E6F7G8H9J0K/businessLicense/business_license.pdf examples: GetInformationRequestAssociatedPersonsPassport: value: id: usrsk-h2vuw0jaswgpzyxluhpz2709 status: DRAFT subjectType: ENROLLMENT subjectId: usrem-coxxvofk5km4tz1r28c7gcfk validationStatus: VALID decision: null title: Business Verification createdAt: '2026-06-09T14:37:04Z' updatedAt: '2026-06-09T14:41:12Z' requirements: - requirementKey: associated_persons title: Associated persons description: >- Identity document: upload a passport, or both sides of a driver's license (front and back), plus a proof of address. cardinality: mode: MULTIPLE min: 1 max: null dataSchema: type: object required: - roles - ownershipPercentage - person properties: roles: type: array title: Roles widget: multiselect minItems: 1 items: type: string enum: - CONTROL_PERSON - BENEFICIAL_OWNER - SIGNER - ADMIN - DIRECTOR - REPRESENTATIVE - BUSINESS_CONTROLLER - BUSINESS_ADMIN - SHAREHOLDER title: type: string title: Title widget: text minLength: 1 maxLength: 150 ownershipPercentage: type: integer title: Ownership percentage widget: number minimum: 0 maximum: 100 person: type: object title: Person required: - firstName - lastName - dateOfBirth - citizenship - email - phoneNumber - taxNumber - physicalAddress properties: firstName: type: string title: First name widget: text minLength: 1 maxLength: 150 lastName: type: string title: Last name widget: text minLength: 1 maxLength: 150 dateOfBirth: type: string title: Date of birth widget: date format: date citizenship: type: string title: Citizenship widget: text minLength: 2 maxLength: 2 email: type: string title: Email widget: email format: email phoneNumber: type: string title: Phone widget: phone minLength: 2 maxLength: 50 taxNumber: type: string title: Tax number widget: text minLength: 2 maxLength: 50 physicalAddress: type: object title: Residential address required: - addressLine1 - city - stateProvince - postalCode - countryCode properties: addressLine1: type: string title: Address line 1 widget: text minLength: 2 maxLength: 150 addressLine2: type: string title: Address line 2 widget: text minLength: 1 maxLength: 150 city: type: string title: City widget: text minLength: 2 maxLength: 50 stateProvince: type: string title: State/province widget: text minLength: 2 maxLength: 50 postalCode: type: string title: Postal code widget: text minLength: 3 maxLength: 10 countryCode: type: string title: Country code widget: text minLength: 2 maxLength: 3 additionalProperties: false additionalProperties: false additionalProperties: false documents: - documentKey: passport minFiles: 0 maxFiles: 1 supportedMimeTypes: - application/pdf - image/jpeg - image/png maxFileSizeBytes: 10485760 - documentKey: drivers_license_front minFiles: 0 maxFiles: 1 supportedMimeTypes: - application/pdf - image/jpeg - image/png maxFileSizeBytes: 10485760 - documentKey: drivers_license_back minFiles: 0 maxFiles: 1 supportedMimeTypes: - application/pdf - image/jpeg - image/png maxFileSizeBytes: 10485760 - documentKey: address_proof minFiles: 1 maxFiles: 1 supportedMimeTypes: - application/pdf maxFileSizeBytes: 10485760 validationStatus: VALID entries: - entryId: associated_persons:0 clientReferenceId: representative-1 validationStatus: VALID data: roles: - BENEFICIAL_OWNER - CONTROL_PERSON - SIGNER title: CEO ownershipPercentage: 100 person: firstName: John lastName: Smith dateOfBirth: '1986-06-01' citizenship: US email: john.smith@acme.example phoneNumber: '+12813308004' taxNumber: 078-05-1120 physicalAddress: addressLine1: 100 Legends Way addressLine2: Apt 5 city: Boston stateProvince: MA postalCode: '02114' countryCode: US documents: - documentKey: passport files: - fileName: passport.png mimeType: image/png sizeBytes: 482311 storageKey: >- uploads/usrsk-h2vuw0jaswgpzyxluhpz2709/associated_persons:0/passport/passport.png - documentKey: drivers_license_front files: [] - documentKey: drivers_license_back files: [] - documentKey: address_proof files: - fileName: residential_address_proof.pdf mimeType: application/pdf sizeBytes: 204800 storageKey: >- uploads/usrsk-h2vuw0jaswgpzyxluhpz2709/associated_persons:0/address_proof/residential_address_proof.pdf GetInformationRequestAssociatedPersonsDriversLicense: value: id: usrsk-rb4caxo5qjkn5rvvz11mwpdz status: DRAFT subjectType: ENROLLMENT subjectId: usrem-d4k1p9wq2zse6n8r0t5y7c3v validationStatus: VALID decision: null title: Business Verification createdAt: '2026-06-09T14:51:03Z' updatedAt: '2026-06-09T14:55:48Z' requirements: - requirementKey: associated_persons title: Associated persons description: >- Identity document: upload a passport, or both sides of a driver's license (front and back), plus a proof of address. cardinality: mode: MULTIPLE min: 1 max: null dataSchema: type: object required: - roles - ownershipPercentage - person properties: roles: type: array title: Roles widget: multiselect minItems: 1 items: type: string enum: - CONTROL_PERSON - BENEFICIAL_OWNER - SIGNER - ADMIN - DIRECTOR - REPRESENTATIVE - BUSINESS_CONTROLLER - BUSINESS_ADMIN - SHAREHOLDER title: type: string title: Title widget: text minLength: 1 maxLength: 150 ownershipPercentage: type: integer title: Ownership percentage widget: number minimum: 0 maximum: 100 person: type: object title: Person required: - firstName - lastName - dateOfBirth - citizenship - email - phoneNumber - taxNumber - physicalAddress properties: firstName: type: string title: First name widget: text minLength: 1 maxLength: 150 lastName: type: string title: Last name widget: text minLength: 1 maxLength: 150 dateOfBirth: type: string title: Date of birth widget: date format: date citizenship: type: string title: Citizenship widget: text minLength: 2 maxLength: 2 email: type: string title: Email widget: email format: email phoneNumber: type: string title: Phone widget: phone minLength: 2 maxLength: 50 taxNumber: type: string title: Tax number widget: text minLength: 2 maxLength: 50 physicalAddress: type: object title: Residential address required: - addressLine1 - city - stateProvince - postalCode - countryCode properties: addressLine1: type: string title: Address line 1 widget: text minLength: 2 maxLength: 150 addressLine2: type: string title: Address line 2 widget: text minLength: 1 maxLength: 150 city: type: string title: City widget: text minLength: 2 maxLength: 50 stateProvince: type: string title: State/province widget: text minLength: 2 maxLength: 50 postalCode: type: string title: Postal code widget: text minLength: 3 maxLength: 10 countryCode: type: string title: Country code widget: text minLength: 2 maxLength: 3 additionalProperties: false additionalProperties: false additionalProperties: false documents: - documentKey: passport minFiles: 0 maxFiles: 1 supportedMimeTypes: - application/pdf - image/jpeg - image/png maxFileSizeBytes: 10485760 - documentKey: drivers_license_front minFiles: 0 maxFiles: 1 supportedMimeTypes: - application/pdf - image/jpeg - image/png maxFileSizeBytes: 10485760 - documentKey: drivers_license_back minFiles: 0 maxFiles: 1 supportedMimeTypes: - application/pdf - image/jpeg - image/png maxFileSizeBytes: 10485760 - documentKey: address_proof minFiles: 1 maxFiles: 1 supportedMimeTypes: - application/pdf maxFileSizeBytes: 10485760 validationStatus: VALID entries: - entryId: associated_persons:0 clientReferenceId: representative-1 validationStatus: VALID data: roles: - BENEFICIAL_OWNER - CONTROL_PERSON - SIGNER title: CEO ownershipPercentage: 100 person: firstName: John lastName: Smith dateOfBirth: '1986-06-01' citizenship: US email: john.smith@acme.example phoneNumber: '+12813308004' taxNumber: 078-05-1120 physicalAddress: addressLine1: 100 Legends Way addressLine2: Apt 5 city: Boston stateProvince: MA postalCode: '02114' countryCode: US documents: - documentKey: passport files: [] - documentKey: drivers_license_front files: - fileName: drivers_license_front.png mimeType: image/png sizeBytes: 391044 storageKey: >- uploads/usrsk-rb4caxo5qjkn5rvvz11mwpdz/associated_persons:0/drivers_license_front/drivers_license_front.png - documentKey: drivers_license_back files: - fileName: drivers_license_back.png mimeType: image/png sizeBytes: 358927 storageKey: >- uploads/usrsk-rb4caxo5qjkn5rvvz11mwpdz/associated_persons:0/drivers_license_back/drivers_license_back.png - documentKey: address_proof files: - fileName: residential_address_proof.pdf mimeType: application/pdf sizeBytes: 204800 storageKey: >- uploads/usrsk-rb4caxo5qjkn5rvvz11mwpdz/associated_persons:0/address_proof/residential_address_proof.pdf ````