Get API version

GET

/version

Last modified:2026-10-07 23:39:33

OperationId:Version

Returns the build that the answering server runs. Behind a load balancer, hostname in the response tells you which server replied. To check the API's dependencies rather than its build, use GET /health.

Without a token, the response carries only apiversion, git-commit, hostname, and current-time. With a valid token it also carries the full commit hash, the branch, the build date, and the PHP and framework versions. No token is needed. You can still send one (a bearer access token, an API key, or the ns_access_token cookie) to get the longer response. Any valid token works, whatever its scope. A token that is sent but is invalid or expired is refused with 401, and an API key that is not valid with 403; you do not get the shorter response instead.

current-time is YYYY-MM-DD hh:mm:ss with no offset, not RFC 3339. Takes no parameters.

Request

None

Responses

🟢200OK

application/json

Build information for the server that answered. The optional fields are present only with a valid token.

Bodyapplication/json

🟠401Invalid token

🟠403Invalid API key

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/version' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Without a token

{
    "apiversion": "46.0.1234",
    "git-commit": "a1b2c3d",
    "hostname": "core1.example.com",
    "current-time": "2026-09-01 14:30:00"
}

Modified at 2026-10-07 23:39:33

Check API health