The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks
The Go client covers the statutes, session law, watch, board, credit and pricing operations of the US Data API and mirrors the behavior of the Python SDK.
The operations without a method yet are listed in the SDKs overview.
For the options shared by all SDKs, see the SDKs overview.
Requires Go 1.23 or newer, because the paging iterators use iter.Seq2.
The module lives in the go/ subdirectory of the repository, so its path ends in /go and its release tags are go/vX.Y.Z.Install the latest release:
Every method takes a context.Context first, returns a typed value and an error, and never panics.
Optional request fields are pointers, so use vaquill.Ptr("wa").
Fields that accept one value or a list use vaquill.StringOrList{"wa", "ca"}.Client options: WithAPIKey, WithBaseURL, WithTimeout (0 disables), WithMaxRetries, WithHTTPClient, WithDefaultHeaders, WithUserAgentSuffix, WithMaxCredits, WithAutoIdempotencyKeys, WithLogger.
Per-call options: WithRequestTimeout, WithRequestMaxRetries, WithIdempotencyKey, WithRequestHeader, WithResponse.Read the status, request id and credits of a call with WithResponse.
var info vaquill.ResponseInfores, err := client.Statutes.Count(ctx, req, vaquill.WithResponse(&info))fmt.Println(info.StatusCode, info.RequestID, info.CreditsChargedThisCall(), info.IdempotentReplayed)
Header, Body, RateLimit and CreditsConsumed are on the same value.
CreditsConsumed is the top-level creditsConsumed of the body.
When the top level has no number, Go reads meta.creditsConsumed, because the watch change diff route reports its charge there.
CreditsChargedThisCall is zero on an idempotent replay and feeds WithMaxCredits.
client.Raw sends any request and returns the undecoded body.
All SDK errors implement vaquill.Error.
HTTP failures are typed per status and per machine code, and every one unwraps to *vaquill.APIError, which carries StatusCode, Code, RequestID, Retryable, RetryAfterSeconds, Errors, Body and Headers.
var rl *vaquill.RateLimitErrorswitch {case errors.As(err, &rl): time.Sleep(time.Duration(*rl.RetryAfterSeconds) * time.Second)case errors.Is(err, vaquill.ErrInsufficientCredits): // top upcase errors.Is(err, vaquill.ErrNotFound):}
Other types: ConnectionError, TimeoutError, ResponseParseError (a malformed 2xx body), SpendGuardError, ConfigError and WebhookVerificationError.
A 422 message ends with the first validation reasons from errors[].
IdempotencyKeyReused is also an unprocessable-entity error, and IdempotencyInProgress is also a conflict.
The SDKs retry 408, 429 and 5xx responses, plus a 409 only for idempotency_in_progress.
Connection errors and timeouts are retried when it is safe to do so.
The default is 2 retries, and setting the retry limit to 0 turns retries off.
Backoff starts at 0.5 seconds, doubles to an 8 second cap and is scaled down by 0 to 25 percent jitter.
The wait comes from the retry-after-ms header first, then Retry-After (seconds or an HTTP date), then the body’s retryAfterSeconds.
A wait above 120 seconds is not slept: the error is raised at once.
Never retried: a 402insufficient_credits, daily_cap_exceeded, any other 4xx, and anything the server marks retryable: false.Go specifics:
501 is not retried.
A transport error that may have reached the server is retried only for GET and HEAD, or when an idempotency key is set.
A 5xx on a charged call is not retried without an idempotency key.
Each charged call sends one generated Idempotency-Key, reused on every retry of that call.
When the server honours the key it replays the stored response instead of charging again, and the response reports that it was replayed.
Pass your own key to choose it.Charged POSTs get a generated UUID key unless you pass one.
Keys must be 16 to 255 visible ASCII characters. An empty or invalid key is rejected before any request.
ResponseInfo.IdempotentReplayed tells you the server replayed a stored response, so nothing new was charged.
Once the cap is reached, the next charged call fails with *vaquill.SpendGuardError without sending a request.
The guard is exact: how it stays exact is on the overview.
client.CreditsSpent() reads the running total.
Pages() yields whole pages and Collect() returns a slice.
Charged endpoints spend credits on every page. Always set WithMaxPages or WithMaxItems.
Truncated reports that a guard stopped the walk early.
Stuck reports that the server repeated its offset or cursor, or answered an empty page with hasMore: true, and the SDK stopped instead of spending on the same page again.Iterators: Statutes.IterSearch, IterDivisions, IterSectionChanges; SessionLaws.IterSearch, IterList, IterBody, IterChanges; Boards.IterList; Watches.IterList, IterChanges.Batch helpers split large inputs, remove duplicates and derive a per-chunk idempotency key.
Secrets are whsec_ plus base64.
Pass several secrets to VerifyWebhookSecrets or UnwrapWebhookSecrets while rotating.
An empty or blank secret, including a bare whsec_, or an empty secret list, returns ErrEmptyWebhookSecret. It is a configuration error, not a signature failure.
A whsec_ secret whose remainder is not valid base64 returns ErrInvalidWebhookSecret instead of using the text as the key. Test both with errors.Is.
The default timestamp tolerance is 5 minutes (WithWebhookTolerance).
WithLegacySignature accepts the older X-Vaquill-Signature header, which has no replay protection.
SignWebhook produces headers for your own tests.See Alerts for the payload and delivery behavior.
The SDK follows semantic versioning, and vaquill.Version holds the version. Requests carry User-Agent: vaquill-go/<version>.
The released version is in the SDKs overview table.
While the major version is 0, minor releases may change the API.
A server Deprecation or Sunset header makes the client log one warning per route.
vaquill.Operations lists every operation with its method, path and whether it is charged.Run the tests from a checkout of the repository.
go test -race ./...
Last modified on November 7, 2026
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vaquill AI","description":"US primary law as a developer API. The US Code, the CFR, the Federal Register, state and territory statute codes, state regulations, constitutions and court rules, with Bluebook citation resolution and point-in-time retrieval over REST, MCP and SQL.","colors":{"primary":"#6E3730","light":"#8C4A3F","dark":"#5A2D27"},"logo":{"light":"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/logo/light.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=1c97b6018caaa1fee0a743b05651bb81","dark":"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/logo/dark.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=857ee7c2383d363ffe7fac6f94ad862b","href":"https://vaquill.ai"},"favicon":"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/favicon.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=e9fd33556ddcb3576db2925e6f4e27fe","api":{"openapi":"https://api.vaquill.ai/external/openapi.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","python","javascript","go"],"prefill":true},"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://api.vaquill.ai"}},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#FAFAF9"}},"navbar":{"links":[{"icon":"github","href":"https://vaquill.ai/open-us-law","label":"Open US Law Dataset"},{"href":"mailto:contact@vaquill.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.vaquill.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/vaquill","youtube":"https://www.youtube.com/@vaquill","slack":"https://join.slack.com/t/vaquillaicommunity/shared_invite/zt-3qxv4mtxg-64mtkVe2PxodDMwKGPfvMQ","github":"https://github.com/Vaquill-AI"},"links":[{"header":"Company","items":[{"label":"About","href":"https://vaquill.ai/about"},{"label":"Contact","href":"https://vaquill.ai/contact"},{"label":"Data Sources \u0026 Credits","href":"https://vaquill.ai/partners"},{"label":"Blog","href":"https://vaquill.ai/blog"},{"label":"Engineering","href":"https://vaquill.ai/engineering"}]},{"header":"Developers","items":[{"label":"Data API","href":"https://vaquill.ai/legal-api"},{"label":"MCP Servers","href":"https://vaquill.ai/mcp"},{"label":"API Reference","href":"/api-reference/us-statutes/search-us-statutes-constitutions-court-rules-and-executive-actions"},{"label":"Open US Law Dataset","href":"https://vaquill.ai/open-us-law"}]},{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://vaquill.ai/privacy"},{"label":"Terms of Service","href":"https://vaquill.ai/terms"},{"label":"DPA","href":"https://vaquill.ai/dpa"},{"label":"Cookie Policy","href":"https://vaquill.ai/cookies"},{"label":"Refund Policy","href":"https://vaquill.ai/refund-policy"},{"label":"Delete My Data","href":"https://vaquill.ai/delete-data"},{"label":"Security","href":"https://vaquill.ai/security"},{"label":"Accessibility","href":"https://vaquill.ai/accessibility"},{"label":"Do Not Sell or Share My Personal Information","href":"https://vaquill.ai/privacy"}]}]},"search":{"prompt":"Search docs, guides, and the API reference..."},"seo":{"metatags":{"canonical":"https://www.vaquill.ai/docs","og:site_name":"Vaquill AI Docs","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@vaquillai"},"indexing":"all"},"fonts":{"heading":{"family":"Source Serif 4","weight":400},"body":{"family":"Schibsted Grotesk","weight":400}},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":"github-light"},"latex":false},"errors":{"404":{"redirect":false,"title":"Page not found","description":"That page doesn't exist, or the URL changed. Try the search bar above, or start from the [API overview](/api-guide/overview)."}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","cursor","vscode","windsurf","mcp"],"display":"header"},"thumbnails":{"appearance":"light","fonts":{"family":"Source Serif 4"}},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock","href":"/api-guide/changelog"},{"anchor":"MCP","icon":"plug","href":"/integrations/mcp/vaquill"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vaquill","hasAudioNarration":false,"actualSubdomain":"vaquill","customDomains":["vaquill.ai"],"gitSource":{"type":"github","owner":"vaquill-ai","repo":"vaquill-ai-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aeeddf969e61846fb374a5a","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Guide","count":56},{"language":"default","tag":"US API reference","count":46},{"language":"default","tag":"India API reference","count":30},{"language":"default","tag":"Endpoints","count":28},{"language":"default","tag":"Indian Acts and Legislation","count":18},{"language":"default","tag":"US Statutes","count":18},{"language":"default","tag":"Guides","count":15},{"language":"default","tag":"Core concepts","count":15},{"language":"default","tag":"Integrations","count":14},{"language":"default","tag":"Get started","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":":root{--vq-ink: #1c1a17;--vq-muted: #5f5a52;--vq-hairline: #e4e3e0;--vq-raised: #f2f1ef;--vq-radius: 6px}#navbar img{height:3rem;width:auto}footer img{height:3rem;width:auto}#page-title,#content h2,#content h3{font-family:\"Source Serif 4\", Georgia, serif;font-weight:400;letter-spacing:-0.01em;color:var(--vq-ink)}#content h4,#content h5{font-weight:500}.card,.callout,.accordion,.accordion-group,[data-component-part=\"code-block-root\"]{border-radius:var(--vq-radius)!important;box-shadow:none!important}.card,.accordion,.accordion-group{border:1px solid var(--vq-hairline)}.accordion-group .accordion{border:0!important;border-radius:0!important;margin-bottom:0}.accordion-group .accordion+.accordion{border-top:1px solid var(--vq-hairline)!important}.card:hover{border-color:#6e3730!important}.callout{background-color:var(--vq-raised);border:1px solid var(--vq-hairline)}.callout[data-callout-type=\"warning\"]{border-color:#7d5310}.callout[data-callout-type=\"danger\"]{border-color:#a4123c}code,pre,.shiki{font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace}[data-component-part=\"code-block-root\"]{border:1px solid var(--vq-hairline)}"}],"page":{"pagePath":"api-guide/sdks/go","slug":"/api-guide/sdks/go","pageMetadata":{"title":"Go SDK","description":"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks","href":"/api-guide/sdks/go"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Go client covers the statutes, session law, watch, board, credit and pricing operations of the US Data API and mirrors the behavior of the `,_jsx(_components.a,{href:`/api-guide/sdks/python`,children:`Python SDK`}),`.\nThe operations without a method yet are listed in the `,_jsx(_components.a,{href:`/api-guide/sdks/overview#which-calls-cost-credits`,children:`SDKs overview`}),`.\nFor the options shared by all SDKs, see the `,_jsx(_components.a,{href:`/api-guide/sdks/overview`,children:`SDKs overview`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`install`,children:`Install`}),`\n`,_jsxs(_components.p,{children:[`Requires Go 1.23 or newer, because the paging iterators use `,_jsx(_components.code,{children:`iter.Seq2`}),`.\nThe module lives in the `,_jsx(_components.code,{children:`go/`}),` subdirectory of the repository, so its path ends in `,_jsx(_components.code,{children:`/go`}),` and its release tags are `,_jsx(_components.code,{children:`go/vX.Y.Z`}),`.`]}),`\n`,_jsx(_components.p,{children:`Install the latest release:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`go`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:` get`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:` github.com/Vaquill-AI/vaquill-sdks/go`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` vaquill `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`github.com/Vaquill-AI/vaquill-sdks/go`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Source: `,_jsxs(_components.a,{href:`https://github.com/Vaquill-AI/vaquill-sdks/tree/main/go`,children:[_jsx(_components.code,{children:`Vaquill-AI/vaquill-sdks`}),`, `,_jsx(_components.code,{children:`go/`})]}),` on GitHub.`]}),`\n`,_jsx(Heading,{level:`2`,id:`quickstart`,children:`Quickstart`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`client, err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`:=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` vaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`NewClient`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`() `}),_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A737D`},children:`// reads VAQUILL_API_KEY`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`if`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`!=`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:` nil`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`\tlog.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Fatal`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(err)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`}`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`defer`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` client.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Close`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`()`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`res, err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`:=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` client.Statutes.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Resolve`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(ctx, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"42 U.S.C. 1983\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`, `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:`nil`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`if`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`!=`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:` nil`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`\tlog.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Fatal`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(err)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`}`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`fmt.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Printf`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:`%+v\\\\n`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`, res)`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Every method takes a `,_jsx(_components.code,{children:`context.Context`}),` first, returns a typed value and an error, and never panics.\nOptional request fields are pointers, so use `,_jsx(_components.code,{children:`vaquill.Ptr(\"wa\")`}),`.\nFields that accept one value or a list use `,_jsx(_components.code,{children:`vaquill.StringOrList{\"wa\", \"ca\"}`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Client options: `,_jsx(_components.code,{children:`WithAPIKey`}),`, `,_jsx(_components.code,{children:`WithBaseURL`}),`, `,_jsx(_components.code,{children:`WithTimeout`}),` (0 disables), `,_jsx(_components.code,{children:`WithMaxRetries`}),`, `,_jsx(_components.code,{children:`WithHTTPClient`}),`, `,_jsx(_components.code,{children:`WithDefaultHeaders`}),`, `,_jsx(_components.code,{children:`WithUserAgentSuffix`}),`, `,_jsx(_components.code,{children:`WithMaxCredits`}),`, `,_jsx(_components.code,{children:`WithAutoIdempotencyKeys`}),`, `,_jsx(_components.code,{children:`WithLogger`}),`.\nPer-call options: `,_jsx(_components.code,{children:`WithRequestTimeout`}),`, `,_jsx(_components.code,{children:`WithRequestMaxRetries`}),`, `,_jsx(_components.code,{children:`WithIdempotencyKey`}),`, `,_jsx(_components.code,{children:`WithRequestHeader`}),`, `,_jsx(_components.code,{children:`WithResponse`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Read the status, request id and credits of a call with `,_jsx(_components.code,{children:`WithResponse`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`var`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` info `}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`vaquill`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`ResponseInfo`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`res, err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`:=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` client.Statutes.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Count`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(ctx, req, vaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`WithResponse`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`\u0026`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`info))`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`fmt.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Println`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(info.StatusCode, info.RequestID, info.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`CreditsChargedThisCall`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(), info.IdempotentReplayed)`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Header`}),`, `,_jsx(_components.code,{children:`Body`}),`, `,_jsx(_components.code,{children:`RateLimit`}),` and `,_jsx(_components.code,{children:`CreditsConsumed`}),` are on the same value.\n`,_jsx(_components.code,{children:`CreditsConsumed`}),` is the top-level `,_jsx(_components.code,{children:`creditsConsumed`}),` of the body.\nWhen the top level has no number, Go reads `,_jsx(_components.code,{children:`meta.creditsConsumed`}),`, because the watch change diff route reports its charge there.\n`,_jsx(_components.code,{children:`CreditsChargedThisCall`}),` is zero on an idempotent replay and feeds `,_jsx(_components.code,{children:`WithMaxCredits`}),`.\n`,_jsx(_components.code,{children:`client.Raw`}),` sends any request and returns the undecoded body.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`All SDK errors implement `,_jsx(_components.code,{children:`vaquill.Error`}),`.\nHTTP failures are typed per status and per machine `,_jsx(_components.code,{children:`code`}),`, and every one unwraps to `,_jsx(_components.code,{children:`*vaquill.APIError`}),`, which carries `,_jsx(_components.code,{children:`StatusCode`}),`, `,_jsx(_components.code,{children:`Code`}),`, `,_jsx(_components.code,{children:`RequestID`}),`, `,_jsx(_components.code,{children:`Retryable`}),`, `,_jsx(_components.code,{children:`RetryAfterSeconds`}),`, `,_jsx(_components.code,{children:`Errors`}),`, `,_jsx(_components.code,{children:`Body`}),` and `,_jsx(_components.code,{children:`Headers`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`var`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` rl `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`*`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`vaquill`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`RateLimitError`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`switch`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`case`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` errors.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`As`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(err, `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`\u0026`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`rl):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`\ttime.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Sleep`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(time.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Duration`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`*`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`rl.RetryAfterSeconds) `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`*`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` time.Second)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`case`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` errors.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Is`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(err, vaquill.ErrInsufficientCredits):`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#6A737D`},children:`\t// top up`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`case`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` errors.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Is`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(err, vaquill.ErrNotFound):`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Other types: `,_jsx(_components.code,{children:`ConnectionError`}),`, `,_jsx(_components.code,{children:`TimeoutError`}),`, `,_jsx(_components.code,{children:`ResponseParseError`}),` (a malformed 2xx body), `,_jsx(_components.code,{children:`SpendGuardError`}),`, `,_jsx(_components.code,{children:`ConfigError`}),` and `,_jsx(_components.code,{children:`WebhookVerificationError`}),`.\nA 422 message ends with the first validation reasons from `,_jsx(_components.code,{children:`errors[]`}),`.\n`,_jsx(_components.code,{children:`IdempotencyKeyReused`}),` is also an unprocessable-entity error, and `,_jsx(_components.code,{children:`IdempotencyInProgress`}),` is also a conflict.`]}),`\n`,_jsx(Heading,{level:`2`,id:`retries-and-idempotency`,children:`Retries and idempotency`}),`\n`,_jsxs(_components.p,{children:[`The SDKs retry `,_jsx(_components.code,{children:`408`}),`, `,_jsx(_components.code,{children:`429`}),` and `,_jsx(_components.code,{children:`5xx`}),` responses, plus a `,_jsx(_components.code,{children:`409`}),` only for `,_jsx(_components.code,{children:`idempotency_in_progress`}),`.\nConnection errors and timeouts are retried when it is safe to do so.\nThe default is 2 retries, and setting the retry limit to 0 turns retries off.\nBackoff starts at 0.5 seconds, doubles to an 8 second cap and is scaled down by 0 to 25 percent jitter.\nThe wait comes from the `,_jsx(_components.code,{children:`retry-after-ms`}),` header first, then `,_jsx(_components.code,{children:`Retry-After`}),` (seconds or an HTTP date), then the body’s `,_jsx(_components.code,{children:`retryAfterSeconds`}),`.\nA wait above 120 seconds is not slept: the error is raised at once.\nNever retried: a `,_jsx(_components.code,{children:`402`}),` `,_jsx(_components.code,{children:`insufficient_credits`}),`, `,_jsx(_components.code,{children:`daily_cap_exceeded`}),`, any other `,_jsx(_components.code,{children:`4xx`}),`, and anything the server marks `,_jsx(_components.code,{children:`retryable: false`}),`.`]}),`\n`,_jsx(_components.p,{children:`Go specifics:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`501 is not retried.`}),`\n`,_jsx(_components.li,{children:`A transport error that may have reached the server is retried only for GET and HEAD, or when an idempotency key is set.`}),`\n`,_jsx(_components.li,{children:`A 5xx on a charged call is not retried without an idempotency key.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each charged call sends one generated `,_jsx(_components.code,{children:`Idempotency-Key`}),`, reused on every retry of that call.\nWhen the server honours the key it replays the stored response instead of charging again, and the response reports that it was replayed.\nPass your own key to choose it.`]}),`\n`,_jsx(_components.p,{children:`Charged POSTs get a generated UUID key unless you pass one.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`client.Statutes.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Search`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(ctx, req, vaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`WithIdempotencyKey`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"report-2026-10-29-search\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`))`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Keys must be 16 to 255 visible ASCII characters. An empty or invalid key is rejected before any request.\n`,_jsx(_components.code,{children:`ResponseInfo.IdempotentReplayed`}),` tells you the server replayed a stored response, so nothing new was charged.`]}),`\n`,_jsx(Heading,{level:`2`,id:`spend-guard`,children:`Spend guard`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`client, _ `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`:=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` vaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`NewClient`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(vaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`WithMaxCredits`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:`25`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`))`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Once the cap is reached, the next charged call fails with `,_jsx(_components.code,{children:`*vaquill.SpendGuardError`}),` without sending a request.\nThe guard is exact: `,_jsx(_components.a,{href:`/api-guide/sdks/overview#spend-guard`,children:`how it stays exact`}),` is on the overview.\n`,_jsx(_components.code,{children:`client.CreditsSpent()`}),` reads the running total.`]}),`\n`,_jsx(Heading,{level:`2`,id:`pagination-and-batch-helpers`,children:`Pagination and batch helpers`}),`\n`,_jsxs(_components.p,{children:[`Paginated endpoints return a `,_jsx(_components.code,{children:`*Paginator[T]`}),` built on `,_jsx(_components.code,{children:`iter.Seq2`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`pager, _ `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`:=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` client.Statutes.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`IterSearch`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(ctx, `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`\u0026`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`vaquill`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`StatuteSearchRequest`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`{Query: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"negligence\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`\tvaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`WithMaxPages`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:`3`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`), vaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`WithMaxItems`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:`100`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`))`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`for`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` item, err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`:=`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:` range`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` pager.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`All`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`\tif`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`!=`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:` nil`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`\t\treturn`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` err`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`\t}`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`\tfmt.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Println`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(item.ActID)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`}`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`fmt.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Println`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(pager.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Truncated`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(), pager.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Stuck`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`())`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Pages()`}),` yields whole pages and `,_jsx(_components.code,{children:`Collect()`}),` returns a slice.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Charged endpoints spend credits on every page. Always set `,_jsx(_components.code,{children:`WithMaxPages`}),` or `,_jsx(_components.code,{children:`WithMaxItems`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Truncated`}),` reports that a guard stopped the walk early.\n`,_jsx(_components.code,{children:`Stuck`}),` reports that the server repeated its offset or cursor, or answered an empty page with `,_jsx(_components.code,{children:`hasMore: true`}),`, and the SDK stopped instead of spending on the same page again.`]}),`\n`,_jsxs(_components.p,{children:[`Iterators: `,_jsx(_components.code,{children:`Statutes.IterSearch`}),`, `,_jsx(_components.code,{children:`IterDivisions`}),`, `,_jsx(_components.code,{children:`IterSectionChanges`}),`; `,_jsx(_components.code,{children:`SessionLaws.IterSearch`}),`, `,_jsx(_components.code,{children:`IterList`}),`, `,_jsx(_components.code,{children:`IterBody`}),`, `,_jsx(_components.code,{children:`IterChanges`}),`; `,_jsx(_components.code,{children:`Boards.IterList`}),`; `,_jsx(_components.code,{children:`Watches.IterList`}),`, `,_jsx(_components.code,{children:`IterChanges`}),`.`]}),`\n`,_jsx(_components.p,{children:`Batch helpers split large inputs, remove duplicates and derive a per-chunk idempotency key.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Helper`}),_jsx(_components.th,{children:`Items per request`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Statutes.ResolveBatchAll`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Statutes.GetSectionsAll`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`50`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SessionLaws.GetBatchAll`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`200`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`webhooks`,children:`Webhooks`}),`\n`,_jsx(_components.p,{children:`Deliveries follow the Standard Webhooks scheme. Verify the raw request body, never a re-encoded one.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`go`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`go`,children:_jsxs(_components.code,{language:`go`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`ev, err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`:=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` vaquill.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`UnwrapWebhook`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(body, r.Header, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"whsec_...\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`if`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` err `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`!=`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:` nil`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`\thttp.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`Error`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`(w, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:`\"bad signature\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`, http.StatusBadRequest)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#D73A49`},children:`\treturn`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#24292E`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Secrets are `,_jsx(_components.code,{children:`whsec_`}),` plus base64.\nPass several secrets to `,_jsx(_components.code,{children:`VerifyWebhookSecrets`}),` or `,_jsx(_components.code,{children:`UnwrapWebhookSecrets`}),` while rotating.\nAn empty or blank secret, including a bare `,_jsx(_components.code,{children:`whsec_`}),`, or an empty secret list, returns `,_jsx(_components.code,{children:`ErrEmptyWebhookSecret`}),`. It is a configuration error, not a signature failure.\nA `,_jsx(_components.code,{children:`whsec_`}),` secret whose remainder is not valid base64 returns `,_jsx(_components.code,{children:`ErrInvalidWebhookSecret`}),` instead of using the text as the key. Test both with `,_jsx(_components.code,{children:`errors.Is`}),`.\nThe default timestamp tolerance is 5 minutes (`,_jsx(_components.code,{children:`WithWebhookTolerance`}),`).\n`,_jsx(_components.code,{children:`WithLegacySignature`}),` accepts the older `,_jsx(_components.code,{children:`X-Vaquill-Signature`}),` header, which has no replay protection.\n`,_jsx(_components.code,{children:`SignWebhook`}),` produces headers for your own tests.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/api-guide/alerts`,children:`Alerts`}),` for the payload and delivery behavior.`]}),`\n`,_jsx(Heading,{level:`2`,id:`versioning`,children:`Versioning`}),`\n`,_jsxs(_components.p,{children:[`The SDK follows semantic versioning, and `,_jsx(_components.code,{children:`vaquill.Version`}),` holds the version. Requests carry `,_jsx(_components.code,{children:`User-Agent: vaquill-go/\u003cversion>`}),`.\nThe released version is in the `,_jsx(_components.a,{href:`/api-guide/sdks/overview`,children:`SDKs overview`}),` table.\nWhile the major version is 0, minor releases may change the API.\nA server `,_jsx(_components.code,{children:`Deprecation`}),` or `,_jsx(_components.code,{children:`Sunset`}),` header makes the client log one warning per route.\n`,_jsx(_components.code,{children:`vaquill.Operations`}),` lists every operation with its method, path and whether it is charged.`]}),`\n`,_jsx(_components.p,{children:`Run the tests from a checkout of the repository.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-light`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#fff`,color:`#24292e`,\"--shiki-dark\":`#24292e`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#6F42C1`},children:`go`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:` test`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#005CC5`},children:` -race`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#032F62`},children:` ./...`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":"github-light"},"config":{},"pageMetadata":{"title":"Go SDK","description":"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks","href":"/api-guide/sdks/go"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Install","slug":"install","depth":2,"children":[]},{"title":"Quickstart","slug":"quickstart","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Retries and idempotency","slug":"retries-and-idempotency","depth":2,"children":[]},{"title":"Spend guard","slug":"spend-guard","depth":2,"children":[]},{"title":"Pagination and batch helpers","slug":"pagination-and-batch-helpers","depth":2,"children":[]},{"title":"Webhooks","slug":"webhooks","depth":2,"children":[]},{"title":"Versioning","slug":"versioning","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"vaquill","siteName":"Vaquill AI","title":"Go SDK - Vaquill AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T07:41:35.066Z","gitLastModified":"2026-11-07T07:41:13.000Z","originalFileLocation":"api-guide/sdks/go.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vaquill AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Go SDK - Vaquill AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vaquill AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.vaquill.ai/docs/api-guide/sdks/go\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vaquill.mintlify.site/docs/_mintlify/api/og/v2?division=SDKs\u0026amp;title=Go+SDK\u0026amp;description=The+Vaquill+Go+client+for+the+US+Data+API%3A+quickstart%2C+errors%2C+retries%2C+spend+guard%2C+pagination+and+webhooks\u0026amp;theme=c0fd5b007b30a7a110519c4a\u0026amp;signature=26f7bda1f5d8a19b55ef0aa5190de7286ef354c0f2f3818078eadb962d0d4bb9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Go SDK - Vaquill AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vaquill.mintlify.site/docs/_mintlify/api/og/v2?division=SDKs\u0026amp;title=Go+SDK\u0026amp;description=The+Vaquill+Go+client+for+the+US+Data+API%3A+quickstart%2C+errors%2C+retries%2C+spend+guard%2C+pagination+and+webhooks\u0026amp;theme=c0fd5b007b30a7a110519c4a\u0026amp;signature=26f7bda1f5d8a19b55ef0aa5190de7286ef354c0f2f3818078eadb962d0d4bb9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/vaquill/cxXYvhk1ARjGdjCs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vaquill AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6E3730\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.vaquill.ai/docs/api-guide/sdks/go\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-guide/sdks/go.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.vaquill.ai/#organization\",\"name\":\"Vaquill AI\",\"url\":\"https://www.vaquill.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vaquill/HoYf91pjRoTl4-t3/logo/light.png?fit=max\u0026auto=format\u0026n=HoYf91pjRoTl4-t3\u0026q=85\u0026s=1c97b6018caaa1fee0a743b05651bb81\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.vaquill.ai/docs#website\",\"name\":\"Vaquill AI\",\"url\":\"https://www.vaquill.ai/docs\",\"publisher\":{\"@id\":\"https://www.vaquill.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.vaquill.ai/docs/api-guide/sdks/go#webpage\",\"url\":\"https://www.vaquill.ai/docs/api-guide/sdks/go\",\"name\":\"Go SDK\",\"description\":\"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks\",\"dateModified\":\"2026-11-07T07:41:13.000Z\",\"isPartOf\":{\"@id\":\"https://www.vaquill.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.vaquill.ai/docs/api-guide/sdks/go#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.vaquill.ai/docs/api-guide/sdks/go#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://www.vaquill.ai/docs/api-guide/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"SDKs\",\"item\":\"https://www.vaquill.ai/docs/api-guide/sdks/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Go SDK\",\"item\":\"https://www.vaquill.ai/docs/api-guide/sdks/go\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.vaquill.ai/docs/api-guide/sdks/go#article\",\"headline\":\"Go SDK\",\"name\":\"Go SDK\",\"description\":\"The Vaquill Go client for the US Data API: quickstart, errors, retries, spend guard, pagination and webhooks\",\"url\":\"https://www.vaquill.ai/docs/api-guide/sdks/go\",\"mainEntityOfPage\":{\"@id\":\"https://www.vaquill.ai/docs/api-guide/sdks/go#webpage\"},\"dateModified\":\"2026-11-07T07:41:13.000Z\",\"publisher\":{\"@id\":\"https://www.vaquill.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.vaquill.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vaquill AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vaquill AI","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock","href":"/api-guide/changelog"},{"anchor":"MCP","icon":"plug","href":"/integrations/mcp/vaquill"}]},"tabs":[{"tab":"Guide","groups":[{"group":"Data coverage","icon":"database","pages":[{"title":"Coverage","href":"/api-guide/coverage"},{"title":"Federal coverage","href":"/api-guide/coverage/federal"},{"title":"Treaty coverage","href":"/api-guide/coverage/treaties"},{"title":"State and territory coverage","href":"/api-guide/coverage/states"},{"title":"Federal agency guidance sources","href":"/api-guide/coverage/agency-guidance"},{"title":"State session laws","href":"/api-guide/session-laws"},{"title":"US rulemaking","href":"/api-guide/rulemaking"}]},{"group":"Get started","icon":"rocket","pages":[{"title":"Quickstart","href":"/api-guide/quickstart"},{"title":"API overview","href":"/api-guide/overview"},{"title":"Authentication","href":"/api-guide/authentication"},{"title":"Use cases","href":"/api-guide/use-cases"},{"group":"SDKs","icon":"code","root":{"title":"SDKs overview","href":"/api-guide/sdks/overview"},"expanded":false,"pages":[{"title":"Python SDK","href":"/api-guide/sdks/python"},{"title":"TypeScript SDK","description":"Install the Vaquill TypeScript client, resolve citations, search statutes and handle errors","href":"/api-guide/sdks/typescript"},{"title":"Go SDK","href":"/api-guide/sdks/go"},{"title":"CLI","description":"Search statutes, resolve citations and check credits from the shell","href":"/api-guide/sdks/cli"},{"title":"Framework integrations","href":"/api-guide/sdks/integrations"},{"group":"JVM (preview)","expanded":false,"pages":[{"title":"Java SDK","tag":"Preview","href":"/api-guide/sdks/java"},{"title":"Kotlin SDK","tag":"Preview","href":"/api-guide/sdks/kotlin"}]}]}]},{"group":"Core concepts","icon":"book-open","pages":[{"title":"How search works","href":"/api-guide/concepts/search"},{"title":"Boolean search","href":"/api-guide/concepts/boolean-search"},{"title":"Corpus types","href":"/api-guide/concepts/corpus-types"},{"title":"Jurisdictions and state codes","href":"/api-guide/concepts/jurisdictions"},{"title":"Hierarchy and container names","href":"/api-guide/concepts/hierarchy"},{"title":"Section identifiers","href":"/api-guide/concepts/section-ids"},{"title":"Response fields","href":"/api-guide/concepts/response-fields"},{"title":"Response formats","href":"/api-guide/concepts/formats"},{"title":"Citation formats","href":"/api-guide/concepts/citation-formats"},{"title":"Pinpoints","href":"/api-guide/concepts/pinpoints"},{"title":"Citation resolution quality","href":"/api-guide/concepts/citation-quality"},{"title":"Section intelligence","href":"/api-guide/concepts/section-intelligence"},{"title":"Point-in-time law","href":"/api-guide/point-in-time"},{"title":"Status and currency","href":"/api-guide/concepts/status-and-currency"},{"title":"Amendment history","href":"/api-guide/concepts/amendment-history"}]},{"group":"Guides","icon":"lightbulb","pages":[{"group":"Recipes","icon":"flask","pages":[{"title":"Ground an LLM answer in statutes (RAG)","sidebarTitle":"Ground an LLM","href":"/api-guide/recipes/rag-grounding"},{"title":"Build a statute lookup chatbot","sidebarTitle":"Statute chatbot","href":"/api-guide/recipes/statute-chatbot"},{"title":"Resolve and verify a statute citation","href":"/api-guide/recipes/citation-lookup"},{"title":"Get one subsection","sidebarTitle":"Get a subsection","href":"/api-guide/recipes/pinpoint-subsection"},{"title":"Browse the statute hierarchy","href":"/api-guide/recipes/browse-hierarchy"},{"title":"Build a subject corpus","sidebarTitle":"Subject corpus","href":"/api-guide/recipes/subject-corpus"},{"title":"Map a compliance requirement to the governing law","href":"/api-guide/recipes/compliance-mapping"},{"title":"Compare a rule across states","sidebarTitle":"Compare states","href":"/api-guide/recipes/multi-state-comparison"},{"title":"Monitor corpus coverage and changes","href":"/api-guide/recipes/coverage-monitoring"},{"title":"Enrich a citation database with source text","href":"/api-guide/recipes/citation-enrichment"},{"title":"Add the corpus as an AI agent tool (MCP)","href":"/api-guide/recipes/mcp-tool"}]},{"title":"Grounding LLMs with Vaquill AI","href":"/api-guide/grounding-llms"},{"title":"Law change alerts","href":"/api-guide/alerts"},{"title":"Pagination","href":"/api-guide/pagination"},{"title":"Best practices","href":"/api-guide/best-practices"}]},{"group":"Bulk data and licensing","icon":"box-archive","pages":[{"title":"Bulk and SQL access","href":"/api-guide/bulk-and-sql"},{"title":"Rights and licensing","href":"/api-guide/rights-and-licensing"}]},{"group":"Reference","icon":"circle-exclamation","pages":[{"title":"Errors and rate limits","href":"/api-guide/errors"},{"title":"Error code reference","href":"/errors/codes"},{"title":"FAQ","href":"/api-guide/faq"},{"title":"Data and privacy","href":"/api-guide/data-privacy"}]},{"group":"Releases","icon":"clock","pages":[{"title":"Changelog","href":"/api-guide/changelog"},{"title":"Roadmap","href":"/api-guide/roadmap"}]}]},{"tab":"US API reference","pages":[{"title":"US API reference","href":"/api-reference/us-statutes/search-us-statutes-constitutions-court-rules-and-executive-actions"}]},{"tab":"India API reference","pages":[{"title":"India API reference","href":"/api-guide/coverage/india"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]}]},"basePath":"","title":"Go SDK - Vaquill AI","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":[],"chunks":[]}