# ORC API Code and Formats - Cyber Only
source: https://developer.mastercard.com/onboard-risk-check/documentation/code-and-formats/cyber-only/index.md

## Error codes {#error-codes}

### Error structure {#error-structure}

Mastercard returns errors in the following structure.

```json
{
  "Errors": {
    "Error": [
      {
        "Source": "<component name>",
        "ReasonCode": "<unique code>",
        "Description": "<description of the error>",
        "Recoverable": "true/false",
        "Details": "<null>"
      }
    ]
  }
}
```

### Service error codes {#service-error-codes}

Note: For more details on ICA, please refer to [Glossary](https://developer.mastercard.com/onboard-risk-check/documentation/glossary/index.md).

The following are service error codes.

| **Error/reason code** |                        **Description**                        |                                                  **Resolution**                                                   |
|-----------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| 400                   | Bad Request.                                                  | Determine that all the fields are valid and not missing.                                                          |
| 401                   | Unauthorized.                                                 | Ensure the client is using a valid ICA.                                                                           |
| 404                   | ClientId not found.                                           | Either the ClientID provided is null or the given ClientID is not authorized. Check if onboarding was successful. |
| 404                   | Resource not Found/Reference Data error (ICA/CID)/Auth error. | Check if IRN is valid. You may not have authority to view details for the given IRN.                              |
| 404                   | Not Found.                                                    | Determine that all the fields are valid and not missing.                                                          |
| 404                   | Not Found.                                                    | Ensure that the customer is using a valid ICA/CID.                                                                |

### Initiate Inquiry using POST endpoint {#initiate-inquiry-using-post-endpoint}

| **Error/reason code** |                        **Description**                        |                                                                                                     **Resolution**                                                                                                     |
|-----------------------|---------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 404                   | ClientId not found.                                           | Either the ClientID provided is null or the given ClientID is not authorized. Check if onboarding was successful.                                                                                                      |
| 404                   | Resource not Found/Reference Data error (ICA/CID)/Auth error. | Check if Inquiry Reference Number (IRN) is valid. You may not have authority to view details for the given IRN.                                                                                                        |
| 404                   | GEO_LOCATION_RESTRICTION.                                     | Certain inquiry types are prohibited in the country associated with the ICA specified. If your business/entity is located in a restricted country for an inquiry type, you will receive this exception in the results. |

### Retrieve Inquiry results using GET endpoint {#retrieve-inquiry-results-using-get-endpoint}

| **Error/reason code** |      **Description**      |                                                                                                     **Resolution**                                                                                                     |
|-----------------------|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 400                   | Bad Request.              | Determine that all the fields are valid and not missing.                                                                                                                                                               |
| 401                   | Unauthorized.             | Ensure the client is using a valid ICA.                                                                                                                                                                                |
| 404                   | Not Found.                | Determine that all the fields are valid and not missing.                                                                                                                                                               |
| 404                   | Not Found.                | Ensure that the customer is using a valid ICA/CID.                                                                                                                                                                     |
| 404                   | GEO_LOCATION_RESTRICTION. | Certain inquiry types are prohibited in the country associated with the ICA specified. If your business/entity is located in a restricted country for an inquiry type, you will receive this exception in the results. |

### Gateway error codes {#gateway-error-codes}

In addition to service error codes, error codes can also be returned by the Mastercard gateway, which is used to verify the signature of your request, and route it to the correct location.
Refer to [Gateway error codes](https://developer.mastercard.com/platform/documentation/security-and-authentication/gateway-error-codes/) for a list of the errors returned by our Gateway, as well as resolutions for each.