Get Visa Application (H1-B)
curl --request GET \
--url https://api.aries.com/v1/stock/visa-application \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v1/stock/visa-application"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/stock/visa-application', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/stock/visa-application",
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: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/stock/visa-application"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/stock/visa-application")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/stock/visa-application")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"symbol": "AAPL",
"data": [
{
"year": 2022,
"quarter": 1,
"symbol": "AAPL",
"caseNumber": "I-200-21364-792636",
"caseStatus": "Certified",
"receivedDate": "2021-12-29",
"visaClass": "H-1B",
"jobTitle": "Acoustics Engineer",
"socCode": "17-2141.00",
"fullTimePosition": "Y",
"beginDate": "2021-12-31",
"endDate": "2024-12-30",
"employerName": "Apple Inc.",
"worksiteAddress": "One Apple Park Way",
"worksiteCity": "Cupertino",
"worksiteCounty": "SANTA CLARA",
"worksiteState": "CA",
"worksitePostalCode": "95014",
"wageRangeFrom": 165000,
"wageRangeTo": 185000,
"wageUnitOfPay": "Year",
"wageLevel": "III",
"h1bDependent": "No"
}
]
}Stock Alternative
Visa Application (H1-B)
Retrieve H1-B and permanent visa applications from the DOL for companies. Data is updated quarterly. Filter by symbol and date range (from, to) on beginDate.
Use Case: Analyze hiring and visa sponsorship trends for public companies.
GET
/
v1
/
stock
/
visa-application
Get Visa Application (H1-B)
curl --request GET \
--url https://api.aries.com/v1/stock/visa-application \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v1/stock/visa-application"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/stock/visa-application', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/stock/visa-application",
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: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/stock/visa-application"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/stock/visa-application")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/stock/visa-application")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"symbol": "AAPL",
"data": [
{
"year": 2022,
"quarter": 1,
"symbol": "AAPL",
"caseNumber": "I-200-21364-792636",
"caseStatus": "Certified",
"receivedDate": "2021-12-29",
"visaClass": "H-1B",
"jobTitle": "Acoustics Engineer",
"socCode": "17-2141.00",
"fullTimePosition": "Y",
"beginDate": "2021-12-31",
"endDate": "2024-12-30",
"employerName": "Apple Inc.",
"worksiteAddress": "One Apple Park Way",
"worksiteCity": "Cupertino",
"worksiteCounty": "SANTA CLARA",
"worksiteState": "CA",
"worksitePostalCode": "95014",
"wageRangeFrom": 165000,
"wageRangeTo": 185000,
"wageUnitOfPay": "Year",
"wageLevel": "III",
"h1bDependent": "No"
}
]
}Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Stock ticker symbol (e.g. AAPL). |
from | string | Yes | From date YYYY-MM-DD (filter on beginDate). |
to | string | Yes | To date YYYY-MM-DD (filter on beginDate). |
Response
Success returns200 OK with a JSON object containing a data array of visa application records (e.g. caseNumber, jobTitle, employerName, wageRangeFrom, visaClass, beginDate, endDate), and symbol.
Errors: 400 when symbol or dates are missing, 401 unauthorized, 404 when no data found, 500 server error.Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Query Parameters
Stock ticker to query. Send the plain uppercase symbol exactly as you'd type it on a brokerage screen, e.g. AAPL, MSFT.
Example:
"AAPL"
Start of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-01-01).
Example:
"2024-01-01"
End of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-12-31).
Example:
"2024-12-31"
Was this page helpful?