> ## 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. The response is the complete matrix: every metered endpoint in the requested jurisdiction with its `credits` and `usdCost`, plus the free endpoints at 0. Read it rather than hardcoding a price; this is the same source the API bills from. ## 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 as `Authorization: Bearer vq_key_...` (preferred) or in the `X-API-Key` header. The `api_key` query parameter also works where a header cannot be set, but a URL ends up in logs and browser history. Sending two different keys in one request is rejected with a 401. **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 | 60 | 1,000 | 2,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: [] - ApiKeyHeader: [] - ApiKeyQuery: [] tags: - name: US Statutes description: >- Search and retrieve US primary law. Covers the United States Code and the Statutes at Large, the Code of Federal Regulations and its annual editions, state statutory codes and administrative regulations, federal and state constitutions, court rules, Federal Register rules and Presidential documents, federal and state agency guidance, agency adjudications, state Attorney General opinions, the Sentencing Guidelines and US tax treaties. Scope a search with the `corpusType` filter, and call `/us/statutes/coverage` for the live jurisdiction-by-corpusType list. - **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 - **Enactments**: Which state session laws a publisher's own tables list against a section (supported jurisdictions only, never a complete history) - name: US Session Laws description: >- State session laws: the acts of each legislature as they were enacted, chapter by chapter, before they are folded into a code. A session law is what the governor signs. It carries the act's own text, including the language it strikes and inserts, its approval and effective dates, and, where the publisher prints one, the code sections it changes. That makes it the source for "which act changed this section, and when did it take effect". Every act has a permanent `sessionLawId` (for example `SSL_MN_2025R_G_Y2025_C1`, Minnesota Laws 2025, regular session, chapter 1) whether or not we hold its text, and a citation or bill number such as `S.F.No. 1552` is accepted where an id goes. v1 serves STATE acts only. Federal session laws (the Statutes at Large, `SAL_` ids) are served by `/us/statutes/section`, and `/us/statutes/resolve` points a session-law citation here. **Start here**: check `/us/statutes/coverage` (free) for what we hold per state: each jurisdiction's `sessionLaws` block lists its sessions, which are complete or only partly collected, and the `series` and `instrumentTypes` that exist. Then **List** a session or a date range to get ids, **Get** one act for its record, then **Body** for its text. A law missing from a partly collected session is a free 404 (`session_not_fully_collected`), not proof it does not exist. - **List**: everything enacted in a state's session, approved in a window, or taking effect on a date - **Get**: one act by id or by citation; dates (`effectiveDates` is always a list), sources and the code sections it affects - **Body**: the act's text as printed, paged by cursor, with amendatory markup preserved where the publisher printed it - **Batch**: up to 50 ids or citations in one call, the same record as Get, billed per law served, with every miss listed and its reason - **Changes**: a sync feed of the registry over an integer cursor (`sinceId`): what began to be served, was corrected, withdrawn or merged The reverse link, from a code section to the acts a publisher's own tables list against it, is `GET /us/statutes/section/{actId}/enactments`. - 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. - name: Credits description: >- Your own credit balance: what is spendable right now, where it came from, and what is about to expire. Free and never charged, so it is safe to poll for low-balance alerting or to pre-flight a batch job. 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. The response is the complete matrix: every metered endpoint in the requested jurisdiction with its `credits` and `usdCost`, plus the free endpoints at 0. Read it rather than hardcoding a price; this is the same source the API bills from. ## Example ```bash curl https://api.vaquill.ai/api/v1/api-credits/pricing ``` operationId: get_pricing_api_v1_api_credits_pricing_get parameters: - name: region in: query required: false schema: anyOf: - enum: - US - IN type: string - type: 'null' description: >- Jurisdiction to price. `US` for the United States primary-law surface, `IN` for the India legislation surface. Defaults to the jurisdiction of the document you are reading, so a caller who does not set it gets the prices for the endpoints that document describes and nothing else. title: Region description: >- Jurisdiction to price. `US` for the United States primary-law surface, `IN` for the India legislation surface. Defaults to the jurisdiction of the document you are reading, so a caller who does not set it gets the prices for the endpoints that document describes and nothing else. 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 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '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. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError 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: - account - acts - alerts - session_laws - 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. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: vq_key_* description: >- API key issued from the developer dashboard. Pass as `Authorization: Bearer vq_key_...` (preferred). ApiKeyHeader: type: apiKey in: header name: X-API-Key description: >- The same API key as a bare header value: `X-API-Key: vq_key_...`. Equivalent to the Bearer form. ApiKeyQuery: type: apiKey in: query name: api_key description: >- The same API key as a query parameter: `?api_key=vq_key_...`. Use only where you cannot set a header. A URL can end up in proxy and server logs, browser history and shared links, so prefer either header form, and rotate a key that has leaked. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.