Errors and status codes

The MapVS API uses standard HTTP status codes. Every error response has a consistent JSON envelope.

Error envelope

{
  "status": "error",
  "error": {
    "code": "validation",
    "message": "Field \"cycle_time_hrs\" must be a positive number."
  }
}

Status codes you'll see

• 200 success
• 201 created
• 204 no content (successful delete)
• 400 bad request (validation failed)
• 401 unauthenticated
• 403 forbidden (auth OK, but no permission)
• 404 not found
• 409 conflict (e.g. duplicate slug)
• 429 rate limited
• 500 internal error - retry after backoff

Common error codes

• validation - field-level input problem
• not_found - resource doesn't exist or you don't have access
• quota_exceeded - you're at your plan cap
• invalid_code - pairing / discount / auth code invalid