show
/api/v1/status
Service status
Returns the status of the API. No authentication required.
Every response from this API, including this one, carries RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy. Exceeding the limit returns 429 with Retry-After in seconds.
Returns
Code: 200
The service status
| Name | Type | Required | Description |
|---|---|---|---|
status
|
Must be a String | Required |
‘ok’ while the API is serving requests |
api_version
|
Must be a String | Required |
Current API version |
documentation_url
|
Must be a String | Required |
Human readable API reference |
openapi_url
|
Must be a String | Required |
OpenAPI description of this API |
developer_portal_url
|
Must be a String | Required |
Developer portal: quickstart, auth, webhooks |
authentication
|
Must be a String | Required |
How to authenticate a request |
rate_limit
|
Must be a Hash | Required |
The rate limit in force |
rate_limit[limit]
|
Must be a Integer | Required |
Requests allowed per window |
rate_limit[window_seconds]
|
Must be a Integer | Required |
Length of the window in seconds |
rate_limit[scope]
|
Must be a String | Required |
What the limit is counted against |
versioning
|
Must be a Hash | Required |
Which versions are served, and how retirement is signalled |
versioning[current]
|
Must be a String | Required |
The version to build against |
versioning[supported]
|
Must be an array of any type | Required |
Every version still serving requests |
versioning[deprecated]
|
Must be an array of any type | Required |
Versions that are deprecated but still serving |
versioning[policy_url]
|
Must be a String | Required |
The published versioning and deprecation policy |
versioning[signalling]
|
Must be a String | Required |
The headers a deprecated version sends |