PT OPS

Error Responses

Standard error shape and status codes used across the API.

Last updated: October 8, 2026

Errors are returned as JSON with an error message:

{ "error": "Train not found" }
StatusMeaning
400Missing or invalid request fields.
401Missing or invalid master key or bearer token; master-key-only endpoints reject bearer tokens.
403A valid bearer token does not have the required resource/action permission.
404Resource not found.
409Conflict – a unique field (e.g. trainNumber, messageName, token name) is already in use.
429Rate limit exceeded. See Rate Limits.
500Unexpected server error.