Submit an Information Request for review

curl --request POST \
  --url https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "ir_01HZX1A2B3C4D5E6F7G8H9J0K",
  "status": "DRAFT",
  "subjectType": "ENROLLMENT",
  "subjectId": "enrollment_123",
  "requirements": [
    {
      "requirementKey": "business_information",
      "cardinality": {
        "mode": "SINGLE",
        "min": 1,
        "max": 1
      },
      "documents": [
        {
          "documentKey": "identityDocumentFront",
          "minFiles": 1,
          "maxFiles": 1,
          "supportedMimeTypes": [
            "<string>"
          ],
          "maxFileSizeBytes": 10485760
        }
      ],
      "validationStatus": "MISSING",
      "entries": [
        {
          "entryId": "associated_persons:0",
          "validationStatus": "MISSING",
          "documents": [
            {
              "documentKey": "passport",
              "files": [
                {
                  "fileName": "business_license.pdf",
                  "mimeType": "application/pdf",
                  "sizeBytes": 204800,
                  "storageKey": "uploads/ir_01HZX1A2B3C4D5E6F7G8H9J0K/businessLicense/business_license.pdf"
                }
              ]
            }
          ],
          "clientReferenceId": "representative-1",
          "data": {}
        }
      ],
      "title": "<string>",
      "description": "<string>",
      "dataSchema": {}
    }
  ],
  "validationStatus": "MISSING",
  "createdAt": "2026-04-01T12:00:00Z",
  "updatedAt": "2026-04-01T12:05:00Z",
  "decision": "PENDING",
  "title": "Business Verification"
}

{
  "message": "<string>",
  "validationErrors": [
    {
      "fieldRef": "<string>",
      "type": "InvalidFormat",
      "message": "<string>"
    }
  ],
  "errorCode": "UNAUTHORIZED"
}

{
  "message": "<string>",
  "validationErrors": [
    {
      "fieldRef": "<string>",
      "type": "InvalidFormat",
      "message": "<string>"
    }
  ],
  "errorCode": "UNAUTHORIZED"
}

{
  "message": "<string>",
  "validationErrors": [
    {
      "fieldRef": "<string>",
      "type": "InvalidFormat",
      "message": "<string>"
    }
  ],
  "errorCode": "UNAUTHORIZED"
}

POST

information-requests

{informationRequestId}

submit

Submit an Information Request for review

curl --request POST \
  --url https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "ir_01HZX1A2B3C4D5E6F7G8H9J0K",
  "status": "DRAFT",
  "subjectType": "ENROLLMENT",
  "subjectId": "enrollment_123",
  "requirements": [
    {
      "requirementKey": "business_information",
      "cardinality": {
        "mode": "SINGLE",
        "min": 1,
        "max": 1
      },
      "documents": [
        {
          "documentKey": "identityDocumentFront",
          "minFiles": 1,
          "maxFiles": 1,
          "supportedMimeTypes": [
            "<string>"
          ],
          "maxFileSizeBytes": 10485760
        }
      ],
      "validationStatus": "MISSING",
      "entries": [
        {
          "entryId": "associated_persons:0",
          "validationStatus": "MISSING",
          "documents": [
            {
              "documentKey": "passport",
              "files": [
                {
                  "fileName": "business_license.pdf",
                  "mimeType": "application/pdf",
                  "sizeBytes": 204800,
                  "storageKey": "uploads/ir_01HZX1A2B3C4D5E6F7G8H9J0K/businessLicense/business_license.pdf"
                }
              ]
            }
          ],
          "clientReferenceId": "representative-1",
          "data": {}
        }
      ],
      "title": "<string>",
      "description": "<string>",
      "dataSchema": {}
    }
  ],
  "validationStatus": "MISSING",
  "createdAt": "2026-04-01T12:00:00Z",
  "updatedAt": "2026-04-01T12:05:00Z",
  "decision": "PENDING",
  "title": "Business Verification"
}

{
  "message": "<string>",
  "validationErrors": [
    {
      "fieldRef": "<string>",
      "type": "InvalidFormat",
      "message": "<string>"
    }
  ],
  "errorCode": "UNAUTHORIZED"
}

{
  "message": "<string>",
  "validationErrors": [
    {
      "fieldRef": "<string>",
      "type": "InvalidFormat",
      "message": "<string>"
    }
  ],
  "errorCode": "UNAUTHORIZED"
}

{
  "message": "<string>",
  "validationErrors": [
    {
      "fieldRef": "<string>",
      "type": "InvalidFormat",
      "message": "<string>"
    }
  ],
  "errorCode": "UNAUTHORIZED"
}

Authorizations

Authorization

string

header

required

Bearer token authentication, for client-server calls.

Send the access token issued by POST /v1/auth/token as Authorization: Bearer {token}. The token carries its own program and user context, so the X-Meridian-* headers are not required. See Authentication.

Headers

X-Meridian-Api-Key

string

Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.

X-Meridian-Timestamp

string

Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.

X-Meridian-Program-Id

string

Server-to-server (HMAC) requests only. Identifies the program context for the request.

X-Meridian-User-Id

string

Server-to-server (HMAC) requests only. Identifies the Meridian user targeted by the request. Required for MULTI_USER integrations; omit for SINGLE_USER.

Path Parameters

informationRequestId

string

required

ID of the Information Request to submit for review.

Response

The submitted Information Request details

Detailed Information Request payload for the authenticated Meridian account

string

required

Unique identifier of the Information Request

Example:

"ir_01HZX1A2B3C4D5E6F7G8H9J0K"

status

enum<string>

required

Current status of the Information Request

Available options:

DRAFT,

PROCESSING_SUBMISSION,

PENDING_REVIEW,

COMPLETED,

CANCELED

Example:

"DRAFT"

subjectType

enum<string>

required

Type of entity the Information Request is associated with

Available options:

ENROLLMENT

Example:

"ENROLLMENT"

subjectId

string

required

Identifier of the entity the Information Request is associated with

Example:

"enrollment_123"

requirements

Information Request Requirement · object[]

required

Requirement contracts and submitted entries for this Information Request

Show child attributes

validationStatus

enum<string>

required

Validation status of the Information Request data. VALID means every rule that can be checked from this Information Request alone passes — field schemas, cross-entry rules and required documents. It is not a promise that submission will succeed: checks against data outside this Information Request, such as whether a business name is already registered, only run on POST /submit and are reported there.

Available options:

MISSING,

VALID,

INVALID

Example:

"MISSING"

createdAt

string<date-time>

required

Timestamp when the Information Request was created

Example:

"2026-04-01T12:00:00Z"

updatedAt

string<date-time>

required

Timestamp when the Information Request was last updated

Example:

"2026-04-01T12:05:00Z"

decision

enum<string> | null

Current manual review decision status for the Information Request, if it has been reviewed

Available options:

PENDING,

APPROVED,

REJECTED,

null

Example:

"PENDING"

title

string | null

Display title for the Information Request

Example:

"Business Verification"

⌘I

Getting Started

Authentication

Enrollment

Transactions

API Reference

Webhooks

Submit an Information Request for review

Authorizations

Headers

Path Parameters

Response