Calling the API
You can access the REST API requests directly, using HTTP methods and endpoints, or use language-specific client SDKs, which wrap the REST API calls and provide helper methods.
Endpoints and realms
A realm is a self-contained deployment of SignalFx that hosts your organization. The API endpoint for a realm contains a realm-specific path segment. For example:
us1realm, the endpoint for sending metrics is
eu0realm, the endpoint for sending metrics is
In the Developer Guide and REST API reference, endpoints contain a
placeholder that you’re expected to replace with the actual name of your realm.
To find the name of your realm, go to your profile page in the web UI.
If you don’t include your realm, SignalFx interprets the endpoint as pointing to the
For example, the endpoint
https://api.signalfx.com/v2 is interpreted as
REST requests require an authentication token. To learn more, see the topic API Authentication.
If SignalFx has enabled permissions for your organization, access to a REST request may be limited by authorization. For a request using a session token, authorization is based on the permissions for the member associated with the token.
SignalFx uses the following timestamp formats:
Dateresponse header value has the format
ddd, dd mmm yyyy hh:mm:ssUTC.
Timestamps: Except where noted, timestamps are in Unix time in the UTC time zone.
Durations: Except where noted, SignalFx uses time durations expressed in milliseconds.
Tracing durations are expressed in microseconds.
© Copyright 2019 SignalFx.Third-party license information