Skip to main content
POST
Searches US Federal Register meeting notices for explicit named participation at recognized public venues. Official schedules are observed records, not proof of attendance. Optional news mentions with a city are derived, never observed attendance. Congressional hearings and committee assignments are not searched. Read coverage before interpreting an empty answer.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
required
Full name of the person. 2 to 150 characters.
string
Role to narrow the name search. 2 to 100 characters.
string
Organization to narrow the name search. 2 to 150 characters.
string
required
First meeting or news-seen date, YYYY-MM-DD, inclusive.
string
required
Last meeting or news-seen date, YYYY-MM-DD, inclusive; at most one year after from.
string
required
Reason for researching this person’s public appearances. Up to 500 characters.
boolean
Also search recent news titles for a named US city; these are derived mentions, not attendance. Defaults to false.
integer
Most appearances to return. From 1 to 200. Defaults to 25.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always person_appearances
object
The answer, described under Result below
object
Where the answer came from and when
boolean
true when the answer was served from OneShot’s store of earlier lookups (or its own copy of a public dataset), false when the source was asked for this call
string
When the record was obtained from its source, as an ISO 8601 UTC time; equals evidence.retrieved_at
string
The public body this call’s data comes from: US Office of the Federal Register, by the input.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
object[]
Appearances.
string
Kind.
object
Observed.
string
Title.
string
At.
object
Venue.
string | null
Building. null when the source gives no value.
string | null
City. null when the source gives no value.
string | null
Role. null when the source gives no value.
string
Source url.
object
Derived.
object
News mention.
object
Value.
string
Title.
string
At.
object
Venue.
string | null
Building. null when the source gives no value.
string | null
City. null when the source gives no value.
string | null
Role. null when the source gives no value.
string
Source url.
string
Rule.
string[]
From.
number
Total.
number
Returned.
boolean
Truncated.
object
Coverage.
object
Federal register.
string
Status.
number
Read.
string
Note.
number | null
Candidates. null when the source gives no value.
object
News.
string
Status.
number
Read.
string
Note.
object
Congressional.
string
Status.
string
Note.
string
Limitation.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • US federal records only. Newest matching notices only, without a publication-date filter; meeting dates are filtered locally. At most two full notices (one with news). Only explicit named speaking participation, a single unambiguous meeting date and a recognized public venue are returned. Recognized buildings: Pentagon, White House, Eisenhower Executive Office Building, Herbert C. Hoover Building and National Academy of Sciences Building, each with Washington in the venue text. Titles containing numbers are omitted to avoid passing through street addresses. Scheduled participation is not proof of attendance. Other notices, venues and date formats may be missed.
  • Optional recent GDELT DOC 2.0 news, not federal records or observed attendance. Only titles explicitly naming the subject and saying in Washington, New York, Boston, Chicago, Los Angeles, San Francisco, Seattle, Miami, Houston or Austin are used. Titles containing numbers are omitted. A named city may be unrelated to the subject; this is only a co-mention. The date is when the news index saw the article, not an event date. Publisher country is never a venue. Older windows may be unavailable.
  • Congressional hearings and committee assignments are NOT searched. An empty result does not mean the person never testified.
  • Appearances put official fields under observed and news fields under derived.news_mention.value with rule and from. News places come from title text, not publisher location.
  • An empty looked result means no qualifying match in the records read. Unavailable means no evidence either way. Network failures fail the call. Coverage is never a complete appearance history.
  • total counts qualifying appearances in the bounded records read, returned counts the output rows, and truncated also flags unread candidates or a full news page. Results are newest first. A purpose is required; refused purposes and suppressed subjects are checked before payment.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}