Optimization Protection

Reporting response codes

Error codes help you debug issues that occur as a result of sending badly formatted requests. The responseMessage is a short string that provides a brief explanation. The following tables list the available reason codes, as well as their possible causes.

The following fields are in the body of the response:

responseStatus: Valid values include: SUCCESS, DENIED, or ERROR. SUCCESS means the request was approved by the issuer or completed successfully. ERROR is only returned for 4XX or 5XX responses.
responseCode: This field contains a shorter description of the processing result. For 200 responses, this may be displayed to the consumer.
responseMessage: This field contains a longer, more descriptive message. These messages are not intended to be displayed to the consumer.
hostMessage: Host refers to the system from which J.P. Morgan has received a response. The hostMessage is mapped to J.P. Morgan’s response fields, but the unaltered message is returned, if received. For 5XX responses, the presence of this field indicates where the error exists.

Tip

The responseStatus, responseCode, and responseMessage fields are required.

Successful responses (200 – 299)

In general, a 200 status code indicates that a request has successfully processed, but does not necessarily mean that the issuer has approved the transaction.

HTTP 200 status codes
Scenario	HTTP Status	responseStatus	responseCode	responseMessage
A successful request is sent with the correct fields	200	SUCCESS	OK	Request accepted.

Client error responses (400 – 499)

A 4XX status code indicates that an error has occurred during request, and provides a list of specific codes. Additional fields are provided in the body of the response to help identify the error. Address the problem, and then resubmit the request.

HTTP 4XX status codes
HTTP Status	responseStatus	responseCode	responseMessage
400	ERROR	BAD_REQUEST	Invalid Input: The profile ID you provided is invalid: %s. Please check and correct it.
400	ERROR	BAD_REQUEST	Validation Error: The request body is invalid. Ensure ReportStartDate is less than or equal to ReportEndDate.
400	ERROR	BAD_REQUEST	Validation Error: The request body is invalid. Both ReportStartDate and ReportEndDate must be either null or not null.
400	ERROR	BAD_REQUEST	Invalid Input: The provided Entity IDs are invalid. Please verify and correct them.
400	ERROR	BAD_REQUEST	Invalid Input: The Report Config ID you provided is invalid. Please verify it.
400	ERROR	BAD_REQUEST	Invalid Input: The Report ID you provided is invalid. Please verify it.
400	ERROR	BAD_REQUEST	Invalid Input: The Config ID %s is invalid. Language code: %s. Please verify the inputs.
400	ERROR	BAD_REQUEST	Authorization Error: Authorization failed. The application ID used is not authorized to access configId.
400	ERROR	BAD_REQUEST	Invalid Input: The UUID provided for reportConfigId is invalid. Please provide a valid UUID.
400	ERROR	BAD_REQUEST	Invalid Input: The userId is null or empty, or the role is invalid or empty. Please provide valid inputs.
400	ERROR	BAD_REQUEST	Invalid Input: The JSON request body is invalid. Please ensure it is correctly formatted.
400	ERROR	BAD_REQUEST	Invalid Input: The reporting group ID entered is invalid: %s. Please verify it.
400	ERROR	BAD_REQUEST	Validation Error: The Reporting Group type is required and cannot be null or empty. Please provide a valid type.
400	ERROR	BAD_REQUEST	Validation Error: Please provide at least one parameter to modify in the request payload.
400	ERROR	BAD_REQUEST	Validation Error: Reporting group status and EntityInfo cannot be modified together. Please adjust the request.
400	ERROR	BAD_REQUEST	Invalid Input: Invalid parameter provided: %s. Supported parameters are groupId and groupType.
400	ERROR	BAD_REQUEST	Validation Error: %s is a prohibited field. Please remove it from the request.
400	ERROR	BAD_REQUEST	Invalid Input: The reportingGroupStatus value provided is invalid. Please provide a valid status.
400	ERROR	BAD_REQUEST	Invalid Input: The report ID %s is invalid. Language code: %s. Please verify the inputs.
400	ERROR	BAD_REQUEST	Authorization Error: Authorization failed. The application ID used is not authorized to access the reportId.
400	ERROR	BAD_REQUEST	Invalid Input: The UUID provided for reportId is invalid. Please provide a valid UUID.
400	ERROR	BAD_REQUEST	Validation Error: This endpoint does not support SplitIndicator requests. Please use POST /v2/reports for such requests.
400	ERROR	BAD_REQUEST	Validation Error: The language preference indicator %s is not supported. Please use a supported indicator.
400	ERROR	BAD_REQUEST	Validation Error: The request can only have one entity type and ID when the entity type is a reporting group.
400	ERROR	BAD_REQUEST	Invalid Input: The reporting group type provided is invalid. Please provide a valid type.
400	ERROR	BAD_REQUEST	Invalid Input: Provided entity IDs are invalid. Please ensure all entity IDs are correct.
400	ERROR	BAD_REQUEST	Invalid Input: The report type ID %s must be numeric. Please provide a valid ID.
400	ERROR	BAD_REQUEST	Validation Error: The EntityType mentioned in the request is not allowed. Please use a valid EntityType.
400	ERROR	BAD_REQUEST	Invalid Input: The given value %s is not a valid ID. Please provide a valid ID.
400	ERROR	BAD_REQUEST	Validation Error: The Entity Type in the request cannot be null. Please provide a valid type.
400	ERROR	BAD_REQUEST	Validation Error: The entity IDs in the request cannot be null or empty. Please provide valid IDs.
400	ERROR	BAD_REQUEST	Validation Error: The entity IDs must be numeric. Please provide valid numeric IDs.
400	ERROR	BAD_REQUEST	System Error: An exception occurred in processReportingGroup. Please try again later.
400	ERROR	BAD_REQUEST	Invalid Input: The date-time format entered is invalid: %s. Please use a valid format.
400	ERROR	BAD_REQUEST	Validation Error: The request body is invalid. ReportingPeriodStartDate must be less than or equal to reportingPeriodEndDate.
400	ERROR	BAD_REQUEST	Validation Error: The request body is invalid. Both reportingPeriodStartDate and reportingPeriodEndDate must be either null or not null.
400	ERROR	BAD_REQUEST	Validation Error: Unable to update; standard configurations cannot be modified.
400	ERROR	BAD_REQUEST	Validation Error: Only entity type, entity ID, config status, and frequency config can be modified in prebuilt configuration.
400	ERROR	BAD_REQUEST	Validation Error: The request can only have one entity type and ID when the entity type is a reporting group.
400	ERROR	BAD_REQUEST	Invalid Input: The reporting group type provided is invalid. Please provide a valid type.
400	ERROR	BAD_REQUEST	Invalid Input: The Report Configuration Identifier provided is invalid. Please verify the ID.
400	ERROR	BAD_REQUEST	Validation Error: The FTI report is not available for the specified report type: %s.
400	ERROR	BAD_REQUEST	Validation Error: The request can only include report sections for FTI Transaction Details and/or Dispute Details.
400	ERROR	BAD_REQUEST	Validation Error: An invalid combination of SectionReportTypeIds and entityTypes was selected.
400	ERROR	BAD_REQUEST	Validation Error: An invalid combination of entity IDs was provided. All entities must belong to the same region.
400	ERROR	BAD_REQUEST	Validation Error: An invalid combination of entity IDs was provided. All entities must be of the same entity type.
400	ERROR	BAD_REQUEST	Invalid Input: The entity type provided in the entityInfo list is invalid. Please provide a valid type.
400	ERROR	BAD_REQUEST	Validation Error: The entityTypeIdentifier is mandatory in Section fields if Split is enabled.
400	ERROR	BAD_REQUEST	Limit Exceeded: The report cannot have more than 10 sections. Please reduce the number of sections.
400	ERROR	BAD_REQUEST	Validation Error: The Section Report Type Name cannot be null or empty. Please provide a valid name.
400	ERROR	BAD_REQUEST	Validation Error: The Section Report Type ID %s does not match the Report Type %s. Please verify the IDs.
400	ERROR	BAD_REQUEST	Limit Exceeded: Configuration limit exceeded. %s active configurations allowed for the given User ID and Entity Type combination.
400	ERROR	BAD_REQUEST	Limit Exceeded: Configuration limit exceeded for entities: %s. Please reduce the number of entities.
400	ERROR	BAD_REQUEST	Validation Error: An empty reporting group cannot be modified. Please provide valid data.
400	ERROR	BAD_REQUEST	Validation Error: The reporting group cannot be modified to have empty childEntityInfo or entityIds.
400	ERROR	BAD_REQUEST	Validation Error: Child entity info cannot be empty and cannot have more than two objects.
400	ERROR	BAD_REQUEST	Validation Error: If using an existing profile configuration, only reportConfigId and frequencyConfig need to be present in the request body.
400	ERROR	BAD_REQUEST	Validation Error: Using an existing configuration, only adhoc report requests can be run. The request body contains a scheduled frequency.
400	ERROR	BAD_REQUEST	Data Retrieval Error: The ReportConfigId %s is not present. Please verify the ID.
400	ERROR	BAD_REQUEST	Validation Error: Report sections cannot be empty when creating a configuration. Please provide valid sections.
400	ERROR	BAD_REQUEST	Validation Error: An invalid combination of entity IDs was provided. All entities must belong to the same MEOD.
400	ERROR	BAD_REQUEST	Validation Error: An invalid combination of SectionReportTypeIds was selected. All must be of the same series.
400	ERROR	BAD_REQUEST	Validation Error: ReportSections cannot be null or empty in a POST request. Please provide valid sections.
400	ERROR	BAD_REQUEST	Validation Error: The Section Report Type ID %s does not match the Report Type %s. Please verify the IDs.
400	ERROR	BAD_REQUEST	Validation Error: An inactive Reporting Group is in the list: %s. Please provide active groups.
400	ERROR	BAD_REQUEST	Validation Error: Report generation failed. Cannot accept ReportGroup RG entity types for splitIndicated reports.
400	ERROR	BAD_REQUEST	Validation Error: Report generation is not supported with multiple entityType and Split Indicator as True.
400	ERROR	BAD_REQUEST	Validation Error: A duplicate attribute was found in the request. Please remove duplicates.
400	ERROR	BAD_REQUEST	Validation Error: The PreBuiltConfigurationId cannot be null for a PreBuilt Config request. Please provide a valid ID.
400	ERROR	BAD_REQUEST	Validation Error: Multiple filename delimiters found: %s. Accepted delimiters are [., _].
400	ERROR	BAD_REQUEST	Validation Error: Incorrect tag format: %s. Tags must be in the format Name=<Allowed Tag Value>.
400	ERROR	BAD_REQUEST	Validation Error: Not all tags are closed: %s. Tags must be in the format Name=<Allowed Tag Value>.
400	ERROR	BAD_REQUEST	Validation Error: The provided action type is not supported. Please use a valid action type.
400	ERROR	BAD_REQUEST	Validation Error: The provided aggregation operation text %s is not valid. Valid values are ['sum', 'avg', 'min', 'max', 'count'].
400	ERROR	BAD_REQUEST	Invalid Input: Invalid entity values provided in the request. Please provide valid values.
400	ERROR	BAD_REQUEST	Validation Error: Invalid entity selection. Please select second-level entities outside of the first-level entity.
400	ERROR	BAD_REQUEST	Validation Error: The provided entity type doesn't match the actual entity types for the given entities, or an invalid combination of entity IDs was provided: %s.
400	ERROR	BAD_REQUEST	Validation Error: The Reporting Group entity %s has a self-referencing parent-child mapping. Please correct the mapping.
400	ERROR	BAD_REQUEST	Validation Error: An invalid combination of entity IDs was provided. All entities must be of the same company: %s.
400	ERROR	BAD_REQUEST	Data Retrieval Error: Unable to find the merchant hierarchy for the given list of entities: %s. Please verify the entities.
400	ERROR	BAD_REQUEST	Invalid Input: The Config Type %s is invalid. Please provide a valid type.
400	ERROR	BAD_REQUEST	Validation Error: The entered custom calculation text %s is not valid. Valid values are [% of, Sum, Diff, Div].
400	ERROR	BAD_REQUEST	Limit Exceeded: Entities limit exceeded. More than 100 entities provided. Please reduce the number.
400	ERROR	BAD_REQUEST	Validation Error: A duplicate entity type was found in the request. Please remove duplicates.
400	ERROR	BAD_REQUEST	Invalid Input: The entity type provided is invalid: %s. EntityType values should be valid.
400	ERROR	BAD_REQUEST	Limit Exceeded: Entities limit exceeded for entity type [%s]. More than 100 entities provided. Please reduce the number.
400	ERROR	BAD_REQUEST	Validation Error: The provided config has more than 2 entity types. Please limit the entity types to 2.
400	ERROR	BAD_REQUEST	Validation Error: Multi Entity is not accepted for PE entity type. Please provide a single entity.
400	ERROR	BAD_REQUEST	Validation Error: Multi Entity is not accepted for FTI entity type. Please provide a single entity.
400	ERROR	BAD_REQUEST	Invalid Input: The entity type provided is invalid: %s. EntityType values should be valid.
400	ERROR	BAD_REQUEST	Validation Error: Invalid file tags delimiters entered: %s. Accepted delimiters are [., _].
400	ERROR	BAD_REQUEST	Validation Error: Invalid file tags entered: %s. Please provide valid tags.
400	ERROR	BAD_REQUEST	Validation Error: The schedule frequency value cannot be empty. Please provide a valid frequency.
400	ERROR	BAD_REQUEST	Validation Error: The reporting file scheduled time should be present and cannot be blank for a scheduled report request.
400	ERROR	BAD_REQUEST	Validation Error: The Reporting Period start/end timestamp cannot be null for an adhoc report request. Start: %s, End: %s.
400	ERROR	BAD_REQUEST	Validation Error: The provided Frequency Configuration is invalid. Please check schedule frequency and date-time formats.
400	ERROR	BAD_REQUEST	Validation Error: The frequency config cannot be empty. Please provide a valid configuration.
400	ERROR	BAD_REQUEST	Validation Error: The Start Time must be before the End Time. Please adjust the times.
400	ERROR	BAD_REQUEST	Validation Error: The schedule frequency entered is invalid: %s. Please provide a valid schedule frequency format.
400	ERROR	BAD_REQUEST	Validation Error: The schedule frequency entered is invalid: %s. Please provide a valid day in the schedule frequency.
400	ERROR	BAD_REQUEST	Validation Error: The Reporting Period end time and start/end timestamp should not be included for a scheduled report request.
400	ERROR	BAD_REQUEST	Validation Error: The Reporting Period start time must be included for daily and weekly scheduled report requests.
400	ERROR	BAD_REQUEST	Validation Error: The Reporting Period end time and start/end timestamp should not be included for monthly scheduled report requests.
400	ERROR	BAD_REQUEST	Validation Error: Invalid header/trailer tags entered. Accepted trailer tags: %s.
400	ERROR	BAD_REQUEST	Validation Error: Invalid delimiter entered: %s. Accepted delimiters: %s.
400	ERROR	BAD_REQUEST	Validation Error: Invalid fields selected in the sort clause: %s. Please provide valid fields.
400	ERROR	BAD_REQUEST	Validation Error: Invalid order selected in the sort clause: %s. Please provide a valid order.
400	ERROR	BAD_REQUEST	Validation Error: Invalid request fields selected: %s. Please provide valid fields.
400	ERROR	BAD_REQUEST	Validation Error: The aggregateOperationText %s is not supported for reportAttributeName %s. Please use a supported operation.
400	ERROR	BAD_REQUEST	Validation Error: The filterAttributeCode/aggregateConditionText %s is not supported for AttributeName %s. Please use a supported code.
400	ERROR	BAD_REQUEST	Validation Error: The entered Report Filter condition/aggregateConditionText %s is not supported. Please use a supported condition.
400	ERROR	BAD_REQUEST	Validation Error: The Filter Condition or aggregateConditionText provided is invalid: %s. Value should be a string or an integer.
400	ERROR	BAD_REQUEST	Validation Error: The filter condition/aggregateConditionText provided is invalid, missing ( or ) in the filter condition: %s.
400	ERROR	BAD_REQUEST	Validation Error: Filter value or aggregateConditionText provided is invalid: %s. Please provide a valid value.
400	ERROR	BAD_REQUEST	Validation Error: Report Filter Value or aggregateConditionText %s is invalid. Please provide a valid value.
400	ERROR	BAD_REQUEST	Validation Error: Invalid report format(s) specified: %s. Please provide valid formats.
400	ERROR	BAD_REQUEST	Limit Exceeded: Entities limit exceeded for reporting group request. More than 10,000 entities provided. Please reduce the number.
400	ERROR	BAD_REQUEST	Validation Error: A duplicate entity type was found in the request. Please remove duplicates.
400	ERROR	BAD_REQUEST	Limit Exceeded: Entities limit exceeded for reporting group entity type [%s]. More than 500 entities provided. Please reduce the number.
400	ERROR	BAD_REQUEST	Validation Error: Entity IDs are required. Please provide at least one entity ID.
400	ERROR	BAD_REQUEST	Validation Error: Minimum 1 entity ID is required. Please provide at least one entity ID.
400	ERROR	BAD_REQUEST	Validation Error: Reporting Group Name or Description cannot be blank. Please provide valid information.
400	ERROR	BAD_REQUEST	Validation Error: Reporting Group Entity list cannot be null or empty. Please provide valid entities.
400	ERROR	BAD_REQUEST	Validation Error: Reporting Group Name is required. Please provide a valid name.
400	ERROR	BAD_REQUEST	Validation Error: Action type cannot be null or blank. Please provide a valid action type.
400	ERROR	BAD_REQUEST	Invalid Input: Invalid action type. Please provide a valid action type.
400	ERROR	BAD_REQUEST	Validation Error: Entity IDs are not required for actionType: deactivate. Please remove entity IDs.
400	ERROR	BAD_REQUEST	Validation Error: Entity IDs are required for actionType: modify. Please provide valid entity IDs.
400	ERROR	BAD_REQUEST	Validation Error: Please enter a valid Group name change indicator. Please provide valid information.
400	ERROR	BAD_REQUEST	Validation Error: Entity IDs are required. Please provide valid entity IDs.
400	ERROR	BAD_REQUEST	Validation Error: Cannot change the report type. Please provide a valid report type.
400	ERROR	BAD_REQUEST	Validation Error: Filter Attribute Name is required. Please provide a valid name.
400	ERROR	BAD_REQUEST	Validation Error: Invalid filter fields selected: %s. Please provide valid fields.
400	ERROR	BAD_REQUEST	Validation Error: Default section is not supported for PDF reports. More than 15 selected columns.
400	ERROR	BAD_REQUEST	Limit Exceeded: The number of fields requested %s exceeds the allowed limit %s for PDF reports. Please reduce the number of fields.
400	ERROR	BAD_REQUEST	Validation Error: AggregateOperation and CustomCalculationOn or CustomCalculationText cannot both be present for the same report field.
400	ERROR	BAD_REQUEST	Validation Error: If ConditionalAggregateIndicator is true, either ConditionalAggregateSubSection or ConditionalAggregateFilterList must be present, not both.
400	ERROR	BAD_REQUEST	Validation Error: Invalid Conditional aggregation columns selected: %s. Please provide valid columns.
400	ERROR	BAD_REQUEST	Validation Error: If ConditionalAggregateIndicator is true, alias, reportAttributeName, conditionalAggregateFilterList, and conditionalAggregateSubSection must have valid values.
400	ERROR	BAD_REQUEST	Validation Error: If AggregateOperationText is provided, alias and reportAttributeName are mandatory.
400	ERROR	BAD_REQUEST	Validation Error: If CustomCalculationText is provided, reportAttributeName is invalid.
400	ERROR	BAD_REQUEST	Validation Error: If CustomCalculationText is provided, alias and CustomCalculationOn fields are mandatory.
400	ERROR	BAD_REQUEST	Validation Error: If CustomCalculationText is '% of', a groupBy clause is mandatory.
400	ERROR	BAD_REQUEST	Validation Error: If CustomCalculationText is 'Diff', 'Sum', or 'Div', a groupBy clause is invalid.
400	ERROR	BAD_REQUEST	Validation Error: One or more invalid 'groupBy' fields selected. All GroupBy attributes should be in this list: %s. Provided fields: %s.
400	ERROR	BAD_REQUEST	Validation Error: If CustomCalculation is 'Div', CustomCalculationOn should have exactly two fields.
400	ERROR	BAD_REQUEST	Validation Error: Invalid 'customCalculationOn' field selected. The value '%s' should be one of these columns: %s.
400	ERROR	BAD_REQUEST	Validation Error: Invalid groupBy fields selected for Custom Calculation. Please provide valid fields.
400	ERROR	BAD_REQUEST	Validation Error: Duplicate values present in field. Please ensure all values are unique.
400	ERROR	BAD_REQUEST	Validation Error: Select a date range within the same month. Please adjust the dates.
400	ERROR	BAD_REQUEST	The report is being generated and will be available shortly. Please check back soon.
400	ERROR	BAD_REQUEST	Validation Error: Multiple report type series found: %s. Please use one report type series per request.
400	ERROR	BAD_REQUEST	Validation Error: Report type name should not be null in report sections: %s. Please provide a valid name.
400	ERROR	BAD_REQUEST	Validation Error: Invalid sort direction: %s. Sort direction values should be valid.
400	ERROR	BAD_REQUEST	Validation Error: Invalid sort field: %s. Sort field values should be valid.
400	ERROR	BAD_REQUEST	Validation Error: Invalid next page header. Please remove it and try again.
400	ERROR	BAD_REQUEST	Validation Error: Entity IDs cannot be null. Please provide valid IDs.
400	ERROR	BAD_REQUEST	Validation Error: Entities or RG provided in the request should be of the same type. Please ensure consistency.
400	ERROR	BAD_REQUEST	Validation Error: EntityInfo array object cannot be empty and cannot have more than 2 child objects. Please provide valid data.
400	ERROR	BAD_REQUEST	Validation Error: Reporting group request cannot have empty entityType, entityList, reportingGroupName, or reportingGroupDescription. Please provide valid information.
401	ERROR	UNAUTHORIZED	Data Retrieval Error: Unable to fetch merchant details for the provided entities: %s. Please check the entity IDs.
401	ERROR	UNAUTHORIZED	Authorization Error: The provided entity ID(s) %s are invalid and not authorized for this request.
401	ERROR	UNAUTHORIZED	Authorization Error: The Authorization Header is invalid. Please provide a valid header.
404	ERROR	NOT_FOUND	Data Retrieval Error: Unable to fetch data from the database using the provided ID. Please verify the ID.
404	ERROR	NOT_FOUND	Data Retrieval Error: No records found. Please verify the request criteria.
404	ERROR	NOT_FOUND	Invalid Input: The report type/ID is incorrect. Please verify the inputs.
404	ERROR	NOT_FOUND	Data Retrieval Error: No records found for %s. Please verify the request criteria.
404	ERROR	NOT_FOUND	Validation Error: The entity IDs for the provided Report ID do not match the Merchant table Entity IDs.
404	ERROR	NOT_FOUND	Authorization Error: The provided entity ID(s) %s are invalid and not authorized for this request.
404	ERROR	NOT_FOUND	Data Retrieval Error: The record with the given Reporting group ID = %s and Type = %s does not exist. Please provide a valid combination.
404	ERROR	NOT_FOUND	Data Retrieval Error: The ReportConfigId %s is not present. Please verify the ID.
404	ERROR	NOT_FOUND	Data Retrieval Error: Error finding Report Type: [%s] from Report Type repository. Please verify the type.
404	ERROR	NOT_FOUND	Data Retrieval Error: Record with config ID = %s does not exist. Please verify the ID.
404	ERROR	NOT_FOUND	Data Retrieval Error: No records found. Please verify the request criteria.
EDG00012	ERROR	Valid Role is not present in Token	Authorization Error: JWT Token validation failed. Please provide a valid token.

Server error responses (500 – 599)

A 5XX status code indicates that an error has occurred within the J.P. Morgan (or acquirer) environment during a request. Additional fields are provided in the body of the response to identify the error.

HTTP 5XX status codes
HTTP Status	responseStatus	responseCode	responseMessage
500	ERROR	Internal Server Error	System Error: An internal server error occurred. Please try again later.
504	ERROR	Gateway Timedout	System Error: A gateway timeout occurred. Please try again later.