API Reference

Error codes

Refer to the following table for commonly-encountered errors in Marco API and how to troubleshoot them.

Code

Description

Troubleshooting

400

Input Error. Check the request payload for issues.

Cause: The request is not formatted properly.

Solution: Check your request payload, headers, and parameters for accuracy, and cross-reference with the API Reference.

403

Access denied. Additional privileges are needed access the requested resource.

Cause: The caller does not have authorized access to the resource.

Solution: Ensure that your API caller account has admin access. For more information, refer to Authorization.

404

Not Found. The requested resource does not exist.

Cause: The resource does not exist.

Solution: Check that the resource ID is correct and try again.

429

Rate Limited. Too many requests.

Cause: Too many requests have been sent in a short amount of time.

Solution: Use bulk endpoints where possible, and otherwise retry with exponential backoff.

500

Unexpected error.

Cause: The server is experiencing issues.

Solution: Retry after a brief moment, and contact Marco Payroll if the issue persists.