> ## Documentation Index > Fetch the complete documentation index at: https://vaquill.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get API credit pricing > Returns the credit-to-price conversion rate and per-endpoint credit costs. **No authentication required.** This endpoint is public and rate-limited only. **1 credit = $0.01 USD.** All API billing is in USD via Dodo Payments. ## Pricing Overview | Endpoint | Operation | Credits | USD | |----------|-----------|---------|-----| | `/us/statutes/search` | US Statutes Search | 4 | $0.04 | | `/us/statutes/section` | US Statute Section (Metadata) | 2 | $0.02 | | `/us/statutes/section/body` | US Statute Section (Full Text) | 6 | $0.06 | ## Example ```bash curl https://api.vaquill.ai/api/v1/api-credits/pricing ``` ## OpenAPI ````yaml https://api.vaquill.ai/external/openapi.json get /api/v1/api-credits/pricing openapi: 3.1.0 info: title: Vaquill Developer API description: >- Public API for legal statutes and legislation. **Authentication**: Pass your API key via the `Authorization: Bearer vq_key_...` header. **Credits**: Each call costs API credits. See `GET /api/v1/api-credits/pricing` for the full pricing matrix. ## Jurisdictions | Jurisdiction | Coverage | `countryCode` | |---|---|---| | **United States** | USC and the Statutes at Large, the CFR and its annual editions, all 52 state and territory statutory codes (50 states plus DC and Puerto Rico), state administrative regulations, court rules, federal and state constitutions, federal agency guidance and adjudications, the Federal Register, the Sentencing Guidelines and US tax treaties. | `US` | See the full [Coverage page](https://www.vaquill.ai/docs/api-guide/coverage) for the jurisdiction-by-jurisdiction breakdown, or call `/us/statutes/coverage` for live counts. Coverage is per (jurisdiction, corpusType) pair, so treat that endpoint as the authoritative list rather than this summary. ## Endpoints - **US Statutes**: Search and retrieve any of the corpora above with full text, resolve a citation to its exact section, browse the statutory hierarchy, read a section as it stood on a past date, and follow its change history, cross-references and defined terms - **Board Watches**: Subscribe to a corpus source and get a webhook or email when it refreshes with real changes (free, API key required) - **Pricing**: Credit costs per endpoint (no auth required) ## Rate limits Limits are enforced per API key and scale with your plan. A `429` response includes a `Retry-After` header. | Plan | Per minute | Per hour | Per day | |---|---|---|---| | Vaquill API Pro | 30 | 500 | 1,000 | | Vaquill API Business | 150 | 2,500 | 10,000 | For full documentation, visit the [API Reference](https://www.vaquill.ai/docs/api-reference/). version: 1.0.0 contact: name: Vaquill API Support url: https://www.vaquill.ai email: support@vaquill.ai license: name: Proprietary url: https://www.vaquill.ai/terms termsOfService: https://www.vaquill.ai/terms servers: - url: https://api.vaquill.ai description: Production security: - ApiKeyAuth: [] tags: - name: US Statutes description: >- Search and retrieve US statutes. Covers the United States Code (USC), Code of Federal Regulations (CFR), all 50 state statutes, constitutions, court rules, executive orders, Federal Register agency rules, agency guidance, and state regulations. Scope a search with the `corpusType` filter. - **Search**: Search across all USC, CFR, state, and regulatory sections - **Section**: Get metadata, citation, hierarchy, and source links for a specific section - **Body**: Get the full text of a section - name: Board Watches description: >- Law-change alerts. Subscribe to a **board** (a tracked corpus source, identified by `corpusType` plus an optional `state`) and get a webhook or email whenever it refreshes with real changes, naming the exact sections that changed. Fetch old-vs-new text for any amended section via the change diff. Boards refresh on their own existing cadence; watching one does not change how often it refreshes. Every endpoint here is **free**: authenticated by API key and rate-limited, but not credit-metered. See the [Law Change Alerts guide](https://www.vaquill.ai/docs/api-guide/alerts) for the full walkthrough. - name: Pricing description: >- Credit pricing and conversion rates. No authentication required. 1 credit = $0.01 USD. externalDocs: description: Full API Reference url: https://www.vaquill.ai/docs/api-reference/ paths: /api/v1/api-credits/pricing: get: tags: - Pricing summary: Get API credit pricing description: >- Returns the credit-to-price conversion rate and per-endpoint credit costs. **No authentication required.** This endpoint is public and rate-limited only. **1 credit = $0.01 USD.** All API billing is in USD via Dodo Payments. ## Pricing Overview | Endpoint | Operation | Credits | USD | |----------|-----------|---------|-----| | `/us/statutes/search` | US Statutes Search | 4 | $0.04 | | `/us/statutes/section` | US Statute Section (Metadata) | 2 | $0.02 | | `/us/statutes/section/body` | US Statute Section (Full Text) | 6 | $0.06 | ## Example ```bash curl https://api.vaquill.ai/api/v1/api-credits/pricing ``` operationId: get_pricing_api_v1_api_credits_pricing_get responses: '200': description: Pricing matrix returned successfully content: application/json: schema: $ref: '#/components/schemas/ApiCreditPricingResponse' example: dollarPerCredit: 0.01 minCredits: 500 maxCredits: 1000000 costs: - endpoint: /us/statutes/search operation: US Statutes Search credits: 4 usdCost: 0.04 description: Search the United States Code (USC) and CFR. category: statutes regions: - US '429': description: Rate limit exceeded content: application/json: example: detail: Rate limit exceeded. Retry after 12 seconds. security: [] components: schemas: ApiCreditPricingResponse: properties: dollarPerCredit: type: number title: Dollarpercredit description: USD cost per 1 credit (0.01 means 1 credit = $0.01). examples: - 0.01 minCredits: type: number title: Mincredits description: Minimum credits per purchase. examples: - 500 maxCredits: type: number title: Maxcredits description: Maximum credits per purchase. examples: - 1000000 costs: items: $ref: '#/components/schemas/ApiCreditCostResponse' type: array title: Costs description: Per-endpoint credit costs (USD). type: object required: - dollarPerCredit - minCredits - maxCredits - costs title: ApiCreditPricingResponse description: Full pricing information for the API credit system. USD only. ApiCreditCostResponse: properties: endpoint: type: string title: Endpoint description: API endpoint path. examples: - /us/statutes/search operation: type: string title: Operation description: Human-readable operation name. examples: - US Statutes Search credits: type: number title: Credits description: Credits consumed per call (1 credit = $0.01 USD). examples: - 4 usdCost: type: number title: Usdcost description: Cost in USD per call. examples: - 0.04 description: type: string title: Description description: What the endpoint does. examples: - >- Hybrid semantic + keyword search across the United States Code (USC), Code of Federal Regulations (CFR), and supported state statutory codes. category: type: string enum: - acts - alerts - statutes title: Category description: Endpoint category. examples: - statutes regions: items: type: string type: array title: Regions description: Jurisdictions this endpoint serves (e.g. ['US']). examples: - - US type: object required: - endpoint - operation - credits - usdCost - description - category title: ApiCreditCostResponse description: Single endpoint credit cost for the pricing matrix. securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: vq_key_* description: >- API key issued from the developer dashboard. Pass as `Authorization: Bearer vq_key_...` ````