curl --request POST \
--url https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/data \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entries": [
{
"requirementKey": "us_business_information",
"entryId": "us_business_information:0",
"data": {
"legalName": "Acme Industries LLC",
"displayName": "Acme Industries",
"registrationNumber": "C1234567",
"incorporationDate": "2020-03-15",
"industry": "Software",
"taxNumber": "98-7654321",
"businessType": "LIMITED_LIABILITY_COMPANY",
"websiteUrl": "https://www.acme.example"
}
},
{
"requirementKey": "us_registered_address",
"entryId": "us_registered_address:0",
"data": {
"addressLine1": "123 Market St",
"addressLine2": "Suite 400",
"city": "San Francisco",
"stateProvince": "CA",
"postalCode": "94105",
"countryCode": "US"
}
},
{
"requirementKey": "associated_persons",
"entryId": "associated_persons:0",
"clientReferenceId": "representative-1",
"data": {
"roles": [
"BENEFICIAL_OWNER",
"CONTROL_PERSON",
"SIGNER"
],
"title": "CEO",
"ownershipPercentage": 60,
"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"
}
}
}
},
{
"requirementKey": "associated_persons",
"entryId": "associated_persons:1",
"clientReferenceId": "representative-2",
"data": {
"roles": [
"DIRECTOR"
],
"title": "Director",
"ownershipPercentage": 40,
"person": {
"firstName": "Jane",
"lastName": "Doe",
"dateOfBirth": "1990-11-23",
"citizenship": "US",
"email": "jane.doe@acme.example",
"phoneNumber": "+14155550199",
"taxNumber": "087-65-4321",
"physicalAddress": {
"addressLine1": "742 Evergreen Terrace",
"city": "San Francisco",
"stateProvince": "CA",
"postalCode": "94110",
"countryCode": "US"
}
}
}
},
{
"requirementKey": "credit_wallet_address",
"entryId": "credit_wallet_address:0",
"data": {
"creditWalletAddress": "0x52908400098527886E0F7030069857D2E4169EE7"
}
},
{
"requirementKey": "credit_wallet_currency",
"entryId": "credit_wallet_currency:0",
"data": {
"creditWalletCurrency": "USDC_ETH"
}
}
]
}
'{
"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,
"maxPdfPages": 20
}
],
"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"
}{
"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"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}Create or update Information Request requirement entry data
Writes structured data for one or more requirement entries.
curl --request POST \
--url https://sandbox-api.va.meridianpay.com/v1/information-requests/{informationRequestId}/data \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entries": [
{
"requirementKey": "us_business_information",
"entryId": "us_business_information:0",
"data": {
"legalName": "Acme Industries LLC",
"displayName": "Acme Industries",
"registrationNumber": "C1234567",
"incorporationDate": "2020-03-15",
"industry": "Software",
"taxNumber": "98-7654321",
"businessType": "LIMITED_LIABILITY_COMPANY",
"websiteUrl": "https://www.acme.example"
}
},
{
"requirementKey": "us_registered_address",
"entryId": "us_registered_address:0",
"data": {
"addressLine1": "123 Market St",
"addressLine2": "Suite 400",
"city": "San Francisco",
"stateProvince": "CA",
"postalCode": "94105",
"countryCode": "US"
}
},
{
"requirementKey": "associated_persons",
"entryId": "associated_persons:0",
"clientReferenceId": "representative-1",
"data": {
"roles": [
"BENEFICIAL_OWNER",
"CONTROL_PERSON",
"SIGNER"
],
"title": "CEO",
"ownershipPercentage": 60,
"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"
}
}
}
},
{
"requirementKey": "associated_persons",
"entryId": "associated_persons:1",
"clientReferenceId": "representative-2",
"data": {
"roles": [
"DIRECTOR"
],
"title": "Director",
"ownershipPercentage": 40,
"person": {
"firstName": "Jane",
"lastName": "Doe",
"dateOfBirth": "1990-11-23",
"citizenship": "US",
"email": "jane.doe@acme.example",
"phoneNumber": "+14155550199",
"taxNumber": "087-65-4321",
"physicalAddress": {
"addressLine1": "742 Evergreen Terrace",
"city": "San Francisco",
"stateProvince": "CA",
"postalCode": "94110",
"countryCode": "US"
}
}
}
},
{
"requirementKey": "credit_wallet_address",
"entryId": "credit_wallet_address:0",
"data": {
"creditWalletAddress": "0x52908400098527886E0F7030069857D2E4169EE7"
}
},
{
"requirementKey": "credit_wallet_currency",
"entryId": "credit_wallet_currency:0",
"data": {
"creditWalletCurrency": "USDC_ETH"
}
}
]
}
'{
"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,
"maxPdfPages": 20
}
],
"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"
}{
"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"
}{
"message": "<string>",
"validationErrors": [
{
"fieldRef": "<string>",
"type": "InvalidFormat",
"message": "<string>"
}
],
"errorCode": "UNAUTHORIZED"
}Authorizations
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
Path Parameters
Body
Requirement entry data write payload
Response
The updated Information Request details
Detailed Information Request payload for the authenticated Meridian account
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.
MISSING, VALID, INVALID "MISSING"