Start with the Go SDK

mkdir secapi-go-quickstart
cd secapi-go-quickstart
go mod init example.com/secapi-go-quickstart
go get github.com/secapi-ai/secapi-go/v2
export SECAPI_API_KEY="secapi_..."

package main

import (
  "fmt"
  "log"
  "os"

  sdkgo "github.com/secapi-ai/secapi-go/v2"
)

func stringValue(value *string) string {
  if value == nil {
    return ""
  }
  return *value
}

func main() {
  client := sdkgo.NewClient(os.Getenv("SECAPI_API_KEY"))
  filing, err := client.LatestFilingAgent(map[string]string{
    "ticker": "AAPL",
    "form": "10-K",
  })
  if err != nil {
    log.Fatal(err)
  }
  fmt.Println(filing.AccessionNumber, filing.FilingDate, stringValue(filing.FilingURL))
}

go run .

func must[T any](value T, err error) T {
  if err != nil { log.Fatal(err) }
  return value
}

roster := must(client.ListSituations(map[string]string{"types": "merger", "statuses": "pending", "limit": "25"}))
detail := must(client.GetSituation("sit_abc123", nil))
byForm := must(client.SituationsByForm("SC 13D", map[string]string{"limit": "25"}))
filings := must(client.SituationFilings("sit_abc123", map[string]string{"limit": "25"}))
summary := must(client.SituationSummary("sit_abc123", nil))
feed := must(client.SituationsFeed(map[string]string{"tickers": "ACME"}))
calendar := must(client.SituationsCalendar(map[string]string{"date_types": "vote,expected_close", "days": "30"}))
stats := must(client.SituationsStats(map[string]string{"window": "30d"}))
issues := must(client.SituationsIssues(map[string]string{"limit": "12"}))
brief := must(client.ExportSituation("sit_abc123", nil))
underwriting := must(client.UnderwriteSituation("sit_abc123", nil))
publicRoster := must(client.EmbedSituations(map[string]string{"limit": "10"}))
publicBrief := must(client.EmbedSituationExport("sit_abc123", nil))
watch := must(client.WatchSituations(sdkgo.SituationWatchParams{
  Name: "ACME situation updates",
  Filters: map[string][]string{"tickers": {"ACME"}},
  Delivery: sdkgo.SituationWatchDelivery{Email: "[email protected]"},
}))
_ = []any{roster, detail, byForm, filings, summary, feed, calendar, stats, issues, brief, underwriting, publicRoster, publicBrief, watch}