Get a company
curl --request GET \
--url https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}', 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.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"jurisdiction_code": "<string>",
"entity_number": "<string>",
"legal_name": "<string>",
"status": "active",
"legal_form": "llc",
"domicile": "domestic",
"search_url": "<string>",
"as_of": "2023-12-25",
"kind": "company",
"status_raw": "<string>",
"legal_form_raw": "<string>",
"formed_on": "2023-12-25",
"dissolved_on": "2023-12-25",
"addresses": {
"registered": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
},
"headquarters": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
},
"mailing": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
}
},
"names": [
{
"name": "<string>",
"kind": "previous_legal",
"started_on": "2023-12-25",
"ended_on": "2023-12-25"
}
],
"parties": [
{
"type": "company",
"name": "<string>",
"roles": [
{
"kind": "registered_agent",
"title": "<string>",
"ownership_percentage": 123,
"started_on": "2023-12-25",
"ended_on": "2023-12-25"
}
],
"address": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
}
}
],
"filings": [
{
"filed_on": "2023-12-25",
"id": "<string>",
"title": "<string>",
"type": {
"code": "<string>",
"name": "<string>"
},
"url": "<string>",
"description": "<string>"
}
],
"relationships": [
{
"kind": "merged_into",
"entity": {
"name": "<string>",
"jurisdiction_code": "<string>",
"entity_number": "<string>"
},
"effective_date": "2023-12-25"
}
],
"contact": {
"websites": [
"<string>"
],
"phone": "<string>",
"fax": "<string>"
},
"industry_codes": [
{
"code": "<string>",
"scheme": "<string>",
"description": "<string>"
}
],
"identifiers": [
{
"scheme": "<string>",
"value": "<string>"
}
],
"entity_url": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Company registrations
Get a company by id
Retrieve a single company by its jurisdiction code and registry company number.
GET
/
v2
/
companies
/
{jurisdiction_code}
/
{company_number}
Get a company
curl --request GET \
--url https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}', 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.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.govfiles.dev/v2/companies/{jurisdiction_code}/{company_number}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"jurisdiction_code": "<string>",
"entity_number": "<string>",
"legal_name": "<string>",
"status": "active",
"legal_form": "llc",
"domicile": "domestic",
"search_url": "<string>",
"as_of": "2023-12-25",
"kind": "company",
"status_raw": "<string>",
"legal_form_raw": "<string>",
"formed_on": "2023-12-25",
"dissolved_on": "2023-12-25",
"addresses": {
"registered": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
},
"headquarters": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
},
"mailing": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
}
},
"names": [
{
"name": "<string>",
"kind": "previous_legal",
"started_on": "2023-12-25",
"ended_on": "2023-12-25"
}
],
"parties": [
{
"type": "company",
"name": "<string>",
"roles": [
{
"kind": "registered_agent",
"title": "<string>",
"ownership_percentage": 123,
"started_on": "2023-12-25",
"ended_on": "2023-12-25"
}
],
"address": {
"raw": "<string>",
"street_address": "<string>",
"street_address_2": "<string>",
"locality": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"country_code": "<string>"
}
}
],
"filings": [
{
"filed_on": "2023-12-25",
"id": "<string>",
"title": "<string>",
"type": {
"code": "<string>",
"name": "<string>"
},
"url": "<string>",
"description": "<string>"
}
],
"relationships": [
{
"kind": "merged_into",
"entity": {
"name": "<string>",
"jurisdiction_code": "<string>",
"entity_number": "<string>"
},
"effective_date": "2023-12-25"
}
],
"contact": {
"websites": [
"<string>"
],
"phone": "<string>",
"fax": "<string>"
},
"industry_codes": [
{
"code": "<string>",
"scheme": "<string>",
"description": "<string>"
}
],
"identifiers": [
{
"scheme": "<string>",
"value": "<string>"
}
],
"entity_url": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Look up a single company when you already know its registry-issued identifier. The response is the company entity — the same record embedded under
results[].company in search results.
curl -s 'https://api.govfiles.dev/v2/companies/us_de/7218394' \
-H "X-API-Key: $GOVFILES_API_KEY"
jurisdiction_code is case-insensitive and must be one of the supported jurisdiction codes. company_number is the registry-issued identifier returned as entity_number on the entity, and must match exactly as it appears on the record.
404 is returned when the company_number is not present in the given jurisdiction — including the case where the same number exists under a different jurisdiction.Authorizations
Path Parameters
Jurisdiction code, e.g. us_de or us_ca.
Registry-assigned entity number.
Response
Company entity.
Required string length:
2 - 5Minimum string length:
1Minimum string length:
1Available options:
active, inactive, dissolved, suspended, merged, withdrawn, unknown Available options:
llc, corporation, nonprofit, limited_partnership, limited_liability_partnership, partnership, trust, other, unknown Available options:
domestic, foreign, unknown Allowed value:
"company"Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes