Skip to main content
GET
/
api
/
v2
/
sos-filing-documents
/
List SOS filing documents
curl --request GET \
  --url https://ivs.idenfy.com/api/v2/sos-filing-documents/ \
  --header 'Authorization: Basic <encoded-value>'
import requests

url = "https://ivs.idenfy.com/api/v2/sos-filing-documents/"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://ivs.idenfy.com/api/v2/sos-filing-documents/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
HttpResponse<String> response = Unirest.get("https://ivs.idenfy.com/api/v2/sos-filing-documents/")
.header("Authorization", "Basic <encoded-value>")
.asString();
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://ivs.idenfy.com/api/v2/sos-filing-documents/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
require 'uri'
require 'net/http'

url = URI("https://ivs.idenfy.com/api/v2/sos-filing-documents/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body
using RestSharp;


var options = new RestClientOptions("https://ivs.idenfy.com/api/v2/sos-filing-documents/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Basic <encoded-value>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://ivs.idenfy.com/api/v2/sos-filing-documents/"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Basic <encoded-value>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
val client = OkHttpClient()

val request = Request.Builder()
.url("https://ivs.idenfy.com/api/v2/sos-filing-documents/")
.get()
.addHeader("Authorization", "Basic <encoded-value>")
.build()

val response = client.newCall(request).execute()
import Foundation

let url = URL(string: "https://ivs.idenfy.com/api/v2/sos-filing-documents/")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.timeoutInterval = 10
request.allHTTPHeaderFields = ["Authorization": "Basic <encoded-value>"]

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))
[
  {
    "id": "<string>",
    "checkedAt": "2023-11-07T05:31:56Z",
    "dataFile": "<string>",
    "reportFile": "<string>",
    "companyName": "<string>",
    "formationDate": "2023-12-25",
    "watchlistHitsCount": -1
  }
]

Authorizations

Authorization
string
header
required

The request must contain basic auth headers where username is API key and password is API secret.
In order for you to start using our API you will need an API key and API secret.
Both can be retrieved by contacting iDenfy's support or iDenfy's sales team.

Query Parameters

checkedAt
string<date-time>[]

Multiple values may be separated by commas.

status
enum<string>
Available options:
FAILED,
FINISHED,
IN_PROGRESS,
NOT_ORDERED,
TIMED_OUT

Response

200 - application/json
id
string
required
read-only
checkedAt
string<date-time> | null
status
enum<string>
Available options:
NOT_ORDERED,
IN_PROGRESS,
FINISHED,
FAILED,
TIMED_OUT
dataFile
string<uri> | null
Pattern: (?:json)$
reportFile
string<uri> | null
Pattern: (?:pdf)$
companyName
string | null
Maximum string length: 100
formationDate
string<date> | null
entityType
enum<string> | null
Available options:
CORPORATION,
LLC,
PARTNERSHIP,
NON_PROFIT,
TRUST,
SOLE_PROPRIETORSHIP
watchlistHitsCount
integer | null
Required range: -2147483648 <= x <= 2147483647