Requirements
An active Farsight® admin account
Authorized API key
Limitations
Get All Sites (GET /v1/sites)
You can retrieve a list of all sites created in your organization using this API. Once authorized, this call will return all sites along with their data.
The following parameters are used to filter, sort, and paginate the list of sites returned in the response. All parameters are optional unless otherwise noted.
Input Parameter | Type | Required | Definition |
ConnectionId | integer | No | The ID of the connection you want to query. |
Limit | integer | No | The number of items you want the API to return. It can range from 1 to 50 (Free) or 1 to 500 (Pro). The default value is set to 25. |
Offset | integer | No | The index of the first item to return. Must be 0 or greater. It is set to 0 by default. |
sort | string | No | Fields used to sort the result. Composed by the name of the field followed by :asc or :desc. Example: id:asc. |
Get One Site (GET /v1/sites/{id})
You can retrieve a site created in your organization using this API. The following parameters are used to find the Site you want to return.
Input Parameter | Type | Required | Definition |
id | integer | Yes | The ID of the Site you want to query. |
Get Site Availability (GET /v1/sites/{id}/availability)
You can retrieve the site availability in your organization using this API. The following parameters can be used to find the Site you want to return.
Input Parameter | Type | Required | Definition |
id | integer | Yes | The ID of the Site you want to query. |
From | string | No | The start date to get availability can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
To | string | No | The end date to get availability can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
Limit | integer | No | The number of items you want the API to return. It can range from 1 to 50 (Free) or 1 to 500 (Pro). The default value is set to 25. |
Offset | integer | No | The index of the first item to return. Must be 0 or greater. It is set to 0 by default. |
Related Content
