curl --request POST \
--url https://app.govly.com/api/tools/v1/sam_registrations/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"states": [
"CA"
],
"naics": [
"541330"
],
"sbaCertification": "any"
}
'import requests
url = "https://app.govly.com/api/tools/v1/sam_registrations/search"
payload = {
"states": ["CA"],
"naics": ["541330"],
"sbaCertification": "any"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({states: ['CA'], naics: ['541330'], sbaCertification: 'any'})
};
fetch('https://app.govly.com/api/tools/v1/sam_registrations/search', 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://app.govly.com/api/tools/v1/sam_registrations/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'states' => [
'CA'
],
'naics' => [
'541330'
],
'sbaCertification' => 'any'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.govly.com/api/tools/v1/sam_registrations/search"
payload := strings.NewReader("{\n \"states\": [\n \"CA\"\n ],\n \"naics\": [\n \"541330\"\n ],\n \"sbaCertification\": \"any\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.govly.com/api/tools/v1/sam_registrations/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"states\": [\n \"CA\"\n ],\n \"naics\": [\n \"541330\"\n ],\n \"sbaCertification\": \"any\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.govly.com/api/tools/v1/sam_registrations/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"states\": [\n \"CA\"\n ],\n \"naics\": [\n \"541330\"\n ],\n \"sbaCertification\": \"any\"\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"uei": "<string>",
"eftIndicator": "<string>",
"cageCode": "<string>",
"legalBusinessName": "<string>",
"dbaName": "<string>",
"websiteUrl": "<string>",
"samWebsiteDomain": "<string>",
"sbaWebsiteDomain": "<string>",
"sbaProfileState": "not_checked",
"sbaProfileObservedAt": "2023-11-07T05:31:56Z",
"sbaProfileCheckedAt": "2023-11-07T05:31:56Z",
"registrationExpiresOn": "2023-12-25",
"registrationStatus": "active",
"lastSeenInExtractOn": "2023-12-25",
"presentInLatestExtract": true,
"registrationPurpose": {
"code": "<string>",
"label": "<string>"
},
"businessTypes": [
{
"code": "<string>",
"label": "<string>"
}
],
"city": "<string>",
"state": "<string>",
"countryCode": "<string>",
"primaryNAICS": "<string>",
"matchedNAICS": [
"<string>"
],
"sbaCertifications": [
{
"code": "<string>",
"label": "<string>",
"expiresOn": "2023-12-25"
}
]
}
],
"meta": {
"count": 123,
"nextCursor": "<string>",
"sourceExtractOn": "2023-12-25"
}
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}Search SAM.gov entity registrations
Search registrations from the public SAM.gov extract. By default, results are active, unexpired registrations in the latest extract. Set includeHistorical to include the latest known version of expired or missing registrations. Each row has a unique combination of UEI and EFT indicator. Use the UEI to group alternate registrations for the same entity. Filters combine with AND. Lists match any listed value. Omit a filter to leave it unrestricted. Unknown fields, nulls, and invalid values return 400. Use query for ranked name and keyword search across legal names, DBA names, public former names, SAM business type labels, and keywords from linked public SBA profiles. Use websiteDomain for an exact domain match from either source. A certification match reports what SAM published for the registration on lastSeenInExtractOn. NAICS matching covers the codes listed on the registration. Small business eligibility under a NAICS code is a separate determination.
curl --request POST \
--url https://app.govly.com/api/tools/v1/sam_registrations/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"states": [
"CA"
],
"naics": [
"541330"
],
"sbaCertification": "any"
}
'import requests
url = "https://app.govly.com/api/tools/v1/sam_registrations/search"
payload = {
"states": ["CA"],
"naics": ["541330"],
"sbaCertification": "any"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({states: ['CA'], naics: ['541330'], sbaCertification: 'any'})
};
fetch('https://app.govly.com/api/tools/v1/sam_registrations/search', 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://app.govly.com/api/tools/v1/sam_registrations/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'states' => [
'CA'
],
'naics' => [
'541330'
],
'sbaCertification' => 'any'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.govly.com/api/tools/v1/sam_registrations/search"
payload := strings.NewReader("{\n \"states\": [\n \"CA\"\n ],\n \"naics\": [\n \"541330\"\n ],\n \"sbaCertification\": \"any\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.govly.com/api/tools/v1/sam_registrations/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"states\": [\n \"CA\"\n ],\n \"naics\": [\n \"541330\"\n ],\n \"sbaCertification\": \"any\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.govly.com/api/tools/v1/sam_registrations/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"states\": [\n \"CA\"\n ],\n \"naics\": [\n \"541330\"\n ],\n \"sbaCertification\": \"any\"\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"uei": "<string>",
"eftIndicator": "<string>",
"cageCode": "<string>",
"legalBusinessName": "<string>",
"dbaName": "<string>",
"websiteUrl": "<string>",
"samWebsiteDomain": "<string>",
"sbaWebsiteDomain": "<string>",
"sbaProfileState": "not_checked",
"sbaProfileObservedAt": "2023-11-07T05:31:56Z",
"sbaProfileCheckedAt": "2023-11-07T05:31:56Z",
"registrationExpiresOn": "2023-12-25",
"registrationStatus": "active",
"lastSeenInExtractOn": "2023-12-25",
"presentInLatestExtract": true,
"registrationPurpose": {
"code": "<string>",
"label": "<string>"
},
"businessTypes": [
{
"code": "<string>",
"label": "<string>"
}
],
"city": "<string>",
"state": "<string>",
"countryCode": "<string>",
"primaryNAICS": "<string>",
"matchedNAICS": [
"<string>"
],
"sbaCertifications": [
{
"code": "<string>",
"label": "<string>",
"expiresOn": "2023-12-25"
}
]
}
],
"meta": {
"count": 123,
"nextCursor": "<string>",
"sourceExtractOn": "2023-12-25"
}
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}{
"errors": [
{
"status": "<string>",
"code": "<string>",
"title": "<string>",
"detail": "<string>",
"source": {
"pointer": "<string>"
}
}
]
}Authorizations
Body
Match an exact website host from SAM or SBA, such as example.com. Case, a leading www. and a trailing dot are ignored.
Use any for at least one reported SBA certification. For a specific program, use A0 for EDWOSB, A4 for SBA-certified Small Disadvantaged Business, A6 for 8(a), A9 for WOSB, JT for an 8(a) joint venture, or XX for HUBZone. Certifications with a known past expiration are excluded. Only entries with a valid expiry or an omitted expiry qualify.
any, A0, A4, A6, A9, JT, XX Was this page helpful?