curl 'https://api.poddata.ai/v1/companies/northwind-dental/records?source=nppes-npi&limit=1' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/companies/{id}/records', 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.poddata.ai/v1/companies/{id}/records",
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.poddata.ai/v1/companies/{id}/records"
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.poddata.ai/v1/companies/{id}/records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/records")
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{
"data": [
{
"id": "rec_01JD9A2B3C4D00000000000000",
"source": "nppes-npi",
"kind": "organization",
"day": "2026-10-02",
"title": "Northwind Dental PC, Riverside",
"fields": {
"npi": "1999999901",
"specialty": "Dentist, General Practice",
"city": "Riverside",
"state": "CA"
},
"text": null,
"url": "https://npiregistry.cms.hhs.gov/provider-view/1999999901",
"revisions": 1,
"link": "cln_01JD8X4K2Q1T00000000000000",
"read": "2026-11-14"
}
],
"next": "MjAyNi0xMC0wMg"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}Records tied to a company by a confirmed link, newest day first
Records PodData read about a company through its confirmed links, newest day first: filings, registrations, licences, inspections, cases, deals, stories and the like. Each has its source, its kind, its own day, a title, its fields, at most 80 words of its own text, its page on the source’s site, how many times it has changed, the link that ties it to the company, and the day PodData last read it. Narrow it with source, kind, from and to. With format=csv, one source’s records of one kind come as a file, a column a field.
Before: The company has the confirmed links its sources read through, and PodData has read them: GET /targets/{company}/coverage says which sources have.
Next: Open one with GET /records/{id}, and what it said before with GET /records/{id}/revisions. For a page’s figures, ask a number tool rather than adding up records.
Limits: 20 a page, or limit, at most 100, with next as the cursor. A file is at most 10,000 rows, and the cursor for the rest comes in the X-PodData-Next header. A file needs source, and kind where that source holds more than one.
curl 'https://api.poddata.ai/v1/companies/northwind-dental/records?source=nppes-npi&limit=1' \
-H "Authorization: Bearer $PODDATA_API_KEY"import requests
url = "https://api.poddata.ai/v1/companies/{id}/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.poddata.ai/v1/companies/{id}/records', 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.poddata.ai/v1/companies/{id}/records",
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.poddata.ai/v1/companies/{id}/records"
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.poddata.ai/v1/companies/{id}/records")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.poddata.ai/v1/companies/{id}/records")
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{
"data": [
{
"id": "rec_01JD9A2B3C4D00000000000000",
"source": "nppes-npi",
"kind": "organization",
"day": "2026-10-02",
"title": "Northwind Dental PC, Riverside",
"fields": {
"npi": "1999999901",
"specialty": "Dentist, General Practice",
"city": "Riverside",
"state": "CA"
},
"text": null,
"url": "https://npiregistry.cms.hhs.gov/provider-view/1999999901",
"revisions": 1,
"link": "cln_01JD8X4K2Q1T00000000000000",
"read": "2026-11-14"
}
],
"next": "MjAyNi0xMC0wMg"
}{
"error": {
"code": "bad_request",
"message": "<string>"
}
}company_records, on PodData’s MCP server at https://api.poddata.ai/mcp, does what this route does, with the same key. See The MCP server.