Skip to main content
GET
/
api
/
v1
/
sov
/
history
List Historical SOVs
curl --request GET \
  --url https://api.sovfixer.com/api/v1/sov/history \
  --header 'Authorization: <api-key>'
{
  "results": [
    {
      "completed_time": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "pingid": "<string>",
      "sovid": "<string>",
      "client_ref": "<string>",
      "incremental": false,
      "is_data_ready": true,
      "revision": 123
    }
  ],
  "cursor_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

​
cursor_id
string

Optional. The last received SOV or SOV Update Data (SUD) id. When this parameter is set, the page of results will start on the next record after this id. Defaults to the first result on or after the start timestamp.

Minimum string length: 1
​
page_size
integer
default:50

Optional. The maximum number of results returned in a page.

Required range: 1 <= x <= 250
​
start
string<date-time>

Optional. Start timestamp for which results will be returned. All timestamps are UTC. It should be formatted like %Y%m%d%H%M%S. E.g. Jan 1 2023 1:00 PM would be given as 20230101130000.

Response

Successful response with a list of historical SOVs.

​
results
object[]
required

SOV and SUD records sorted in ascending order by completion time. Contains up to page_size items.

​
cursor_id
string

The last SOV or SUD id returned in a set of results. Pass this value as cursor_id in the next request to retrieve the following page of results.