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": [
    {
      "id": "<string>",
      "sovid": "<string>",
      "record_type": "ORIG",
      "completed_time": "2023-11-07T05:31:56Z",
      "pingid": "<string>",
      "revision": 123,
      "status": "<string>",
      "client_ref": "<string>",
      "incremental": false
    }
  ],
  "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 SUD id. When this parameter is set, the page of results will start on the next sovid up. 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

Up to page_size number of SOV records, sorted in ascending order, after the start timestamp, beginning with the cursor_id.

​
cursor_id
string

The last SOV or SUD id returned in a set of results.