API Status Codes

Understanding Mtrix API responses will help you troubleshoot integration issues.

HTTP Status Codes

Code	Status	Description
200	OK	The request succeeded
201	Created	Resource created successfully
400	Bad Request	The request was invalid or cannot be served
401	Unauthorized	Authentication credentials missing or invalid
403	Forbidden	Authenticated user does not have required permissions
404	Not Found	The requested resource does not exist
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	An error occurred on the server
503	Service Unavailable	The service is temporarily unavailable

Response Format

All Mtrix API responses follow a consistent format:

{
  "success": true,
  "data": {
    // Response data specific to the endpoint
  },
  "meta": {
    "requestId": "req-1a2b3c4d5e6f",
    "timestamp": "2025-04-25T12:34:56.789Z",
    "processingTime": 45
  }
}

For errors:

json{
  "success": false,
  "error": {
    "code": errorCode,
    "message": errorMessage,
  },
  "meta": {
    "requestId": "req-1a2b3c4d5e6f",
    "timestamp": "2025-04-25T12:34:56.789Z"
  }
}