OpenAPI Spec - Vero OMS Docs

Use the OpenAPI files when generating clients, validating payloads, or giving API context to AI tools.

Specification files

File	Purpose
`/openapi.oms.en.json`	English REST API reference used by the English docs
`/openapi.oms.vi.json`	Vietnamese REST API reference used by the Vietnamese docs

The OMS REST API reference currently contains 51 HTTP operations, including password login, two-factor verification, and session resumption.

Use with AI tools

Give the model the OpenAPI file plus this instruction:

Build against the Vero OMS OpenAPI spec.
Use the operation's method and path exactly.
Use Bearer authentication for protected endpoints.
Inspect the login response status before reading jwt.
For mfa_required, preserve the response cookie and complete two-factor verification.
Validate all path, query, and body fields against the schema.
Treat response schemas as authoritative for payload shape and field meanings.
Handle documented error responses.

Client checklist

Find the operation by method or path.
Read every path, query, header, and body parameter.
Build the request from typed fields, not string concatenation where a structured client is available.
Parse the success response according to the documented schema.
Parse error responses defensively because error payloads can vary by failure point.