{"openapi":"3.1.0","info":{"title":"Filings","version":"1"},"paths":{"/.well-known/oauth-protected-resource":{"get":{"summary":"Protected Resource","operationId":"protected_resource__well_known_oauth_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-protected-resource/mcp":{"get":{"summary":"Protected Resource Mcp","operationId":"protected_resource_mcp__well_known_oauth_protected_resource_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"summary":"As Metadata","operationId":"as_metadata__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-authorization-server/mcp":{"get":{"summary":"As Metadata Mcp","operationId":"as_metadata_mcp__well_known_oauth_authorization_server_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/register":{"post":{"summary":"Register","operationId":"register_register_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/authorize":{"get":{"summary":"Authorize Get","operationId":"authorize_get_authorize_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Authorize Post","operationId":"authorize_post_authorize_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/token":{"post":{"summary":"Token","operationId":"token_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/revoke":{"post":{"summary":"Revoke","operationId":"revoke_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/auth/google/start":{"get":{"summary":"Google Start","operationId":"google_start_auth_google_start_get","parameters":[{"name":"next","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/google/callback":{"get":{"summary":"Google Callback","operationId":"google_callback_auth_google_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/signout":{"post":{"summary":"Signout","operationId":"signout_signout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/account":{"get":{"summary":"Account Get","operationId":"account_get_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/account/keys":{"post":{"summary":"Account New Key","operationId":"account_new_key_account_keys_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/account/keys/revoke":{"post":{"summary":"Account Revoke Key","operationId":"account_revoke_key_account_keys_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/account/close":{"post":{"summary":"Account Close","operationId":"account_close_account_close_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Home","operationId":"home__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api":{"get":{"summary":"Page Api","operationId":"page_api_api_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp":{"get":{"summary":"Page Mcp","operationId":"page_mcp_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/data":{"get":{"summary":"Page Data","operationId":"page_data_data_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/workflows":{"get":{"summary":"Page Workflows","operationId":"page_workflows_workflows_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/pricing":{"get":{"summary":"Page Pricing","operationId":"page_pricing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/about":{"get":{"summary":"Page About","operationId":"page_about_about_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/privacy":{"get":{"summary":"Page Privacy","operationId":"page_privacy_privacy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/terms":{"get":{"summary":"Page Terms","operationId":"page_terms_terms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/support":{"get":{"summary":"Page Support","operationId":"page_support_support_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/docs":{"get":{"summary":"Page Docs","operationId":"page_docs_docs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/signin":{"get":{"summary":"Page Signin","operationId":"page_signin_signin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms":{"get":{"summary":"Page Llms","operationId":"page_llms_llms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/benchmark":{"get":{"summary":"Page Benchmark","operationId":"page_benchmark_benchmark_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cli":{"get":{"summary":"Page Cli","operationId":"page_cli_cli_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cli/SKILL.md":{"get":{"summary":"Cli Skill","description":"The skill text that tells a terminal agent (Claude Code, Codex) when and how to use the CLI.","operationId":"cli_skill_cli_SKILL_md_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cli/filings.py":{"get":{"summary":"Cli Script","description":"The CLI as one standard-library file (`python3 filings.py --help`).","operationId":"cli_script_cli_filings_py_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cli/{name}":{"get":{"summary":"Cli Wheel","description":"The installable wheel (pipx / uv tool install this URL). Only the current version's file name.","operationId":"cli_wheel_cli__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/ready":{"get":{"summary":"Ready","description":"200 once the startup warm-up has run, else 503: the Fly check, so a restarted machine gets\ncallers only with warm caches; deploy and promotion wait on it before their live eval.","operationId":"ready_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/releases":{"get":{"summary":"Releases","operationId":"releases_v1_releases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/employers/identify":{"post":{"summary":"Employers Identify","operationId":"employers_identify_v1_employers_identify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentifyBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/employers/{employer_id}":{"get":{"summary":"Employers Get","operationId":"employers_get_v1_employers__employer_id__get","parameters":[{"name":"employer_id","in":"path","required":true,"schema":{"type":"string","title":"Employer Id"}},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year"}},{"name":"samples","in":"query","required":false,"schema":{"type":"integer","default":3,"title":"Samples"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cases/search":{"post":{"summary":"Cases Search","operationId":"cases_search_v1_cases_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cases/{case_number}":{"get":{"summary":"Cases Get","operationId":"cases_get_v1_cases__case_number__get","parameters":[{"name":"case_number","in":"path","required":true,"schema":{"type":"string","title":"Case Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wages/summary":{"post":{"summary":"Wages Summary","operationId":"wages_summary_v1_wages_summary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/titles/search":{"post":{"summary":"Titles Search","operationId":"titles_search_v1_titles_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings":{"post":{"summary":"Rankings","operationId":"rankings_v1_rankings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sponsorship_check":{"post":{"summary":"Sponsorship","operationId":"sponsorship_v1_sponsorship_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsorshipBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compare_offer":{"post":{"summary":"Offer","operationId":"offer_v1_compare_offer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trends":{"post":{"summary":"Trends","operationId":"trends_v1_trends_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cite":{"get":{"summary":"Cite Get","operationId":"cite_get_v1_cite_get","parameters":[{"name":"what","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"What"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/pricing.json":{"get":{"summary":"Pricing Json","description":"The price list for agents: credits per tool, the plans, what happens when the credits run out. No key.","operationId":"pricing_json_pricing_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms-full.txt":{"get":{"summary":"Llms Full Txt","operationId":"llms_full_txt_llms_full_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IdentifyBody":{"properties":{"query":{"type":"string","minLength":1,"title":"Query"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},"type":"object","required":["query"],"title":"IdentifyBody"},"OfferBody":{"properties":{"role":{"type":"string","title":"Role"},"location":{"type":"string","title":"Location"},"salary":{"type":"number","title":"Salary"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year"},"visa_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visa Class","default":"H-1B"}},"type":"object","required":["role","location","salary"],"title":"OfferBody"},"RankBody":{"properties":{"employer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Id"},"employer_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Query"},"employer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer State"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"soc_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Soc Code"},"worksite_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worksite State"},"worksite_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worksite City"},"case_status":{"type":"string","title":"Case Status","default":"Certified"},"program":{"type":"string","title":"Program","default":"lca"},"limit":{"type":"integer","title":"Limit","default":10},"visa_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visa Class"},"h1b_dependent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"H1B Dependent"},"willful_violator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Willful Violator"},"pw_wage_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pw Wage Level"},"naics_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Code"},"petition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Petition Type"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"seniority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority"},"metro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metro"},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year"},"group_by":{"type":"string","title":"Group By","default":"employer"},"order_by":{"type":"string","title":"Order By","default":"cases"},"min_cases":{"type":"integer","title":"Min Cases","default":5},"employer_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Size"}},"type":"object","title":"RankBody"},"SearchBody":{"properties":{"employer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Id"},"employer_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Query"},"employer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer State"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"soc_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Soc Code"},"worksite_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worksite State"},"worksite_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worksite City"},"case_status":{"type":"string","title":"Case Status","default":"Certified"},"program":{"type":"string","title":"Program","default":"lca"},"limit":{"type":"integer","title":"Limit","default":5},"visa_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visa Class"},"h1b_dependent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"H1B Dependent"},"willful_violator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Willful Violator"},"pw_wage_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pw Wage Level"},"naics_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Code"},"petition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Petition Type"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"seniority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority"},"metro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metro"},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year"}},"type":"object","title":"SearchBody"},"SponsorshipBody":{"properties":{"company":{"type":"string","title":"Company"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year"},"visa_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visa Class","default":"H-1B"}},"type":"object","required":["company"],"title":"SponsorshipBody"},"TrendBody":{"properties":{"employer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Id"},"employer_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Query"},"employer_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer State"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"soc_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Soc Code"},"worksite_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worksite State"},"worksite_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worksite City"},"case_status":{"type":"string","title":"Case Status","default":"Certified"},"program":{"type":"string","title":"Program","default":"lca"},"limit":{"type":"integer","title":"Limit","default":25},"visa_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visa Class"},"h1b_dependent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"H1B Dependent"},"willful_violator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Willful Violator"},"pw_wage_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pw Wage Level"},"naics_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Code"},"petition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Petition Type"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"seniority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority"},"metro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metro"},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year"},"mode":{"type":"string","title":"Mode","default":"by_year"},"base_fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Fiscal Year"},"order_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order By"},"min_cases":{"type":"integer","title":"Min Cases","default":20},"employer_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employer Size"}},"type":"object","title":"TrendBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}