Skip to main content
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>'
{
  "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

ParameterTypeRequiredDescription
symbolstringYesStock ticker symbol (e.g. AAPL).
fromstringYesFrom date YYYY-MM-DD (filter on beginDate).
tostringYesTo date YYYY-MM-DD (filter on beginDate).

​
Response

Success returns 200 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

​
Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

​
symbol
string
required

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"

​
from
string<date>
required

Start of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-01-01).

Example:

"2024-01-01"

​
to
string<date>
required

End of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-12-31).

Example:

"2024-12-31"

Response

Visa application data.

​
data
object[]
​
symbol
string