> ## Documentation Index > Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt > Use this file to discover all available pages before exploring further. # List billing invoices > Returns a list of Stripe invoices for the authenticated user's Stripe customer. Includes all credit purchase invoices. ## OpenAPI ````yaml /openapi/neo.public.openapi.json get /api/v1/billing/invoices openapi: 3.1.0 info: contact: name: ProjectDiscovery url: https://neo.projectdiscovery.io description: Neo API Server - Security agent orchestration platform license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 title: Neo API version: 1.0.0 servers: - description: Production url: https://neo.api.projectdiscovery.io - description: Development url: https://neo.api.dev.projectdiscovery.io - description: Local development url: http://localhost:8080 security: [] tags: - description: Task execution and management name: Tasks - description: Agent listing and management name: Agents - description: Public agent directory name: Agent Directory - description: User file storage management name: Files - description: User working memory management name: Memory - description: Scheduled and recurring task management name: Schedules - description: Knowledge base and semantic search name: Knowledge - description: Encrypted user credentials and API keys name: Secrets - description: Neo API key management for programmatic access name: API Keys - description: User profile and account information name: User - description: Task and LLM usage tracking name: Usage - description: Bring Your Own Key provider management name: BYOK - description: Connect personal AI provider accounts and select them as a model source name: AI Connections - description: Model discovery and capabilities name: Models - description: Third-party integrations name: Integrations - description: Skill knowledge documents for agent prompts name: Skills - description: User-authored tools and toolkit management name: Dynamic Tools - description: Team management and member invitations name: Teams - description: Prompt library management and discovery name: Prompts - description: Slack bot integration for workspace installation and OAuth name: Slack - description: GitHub integration for PR reviews and repository management name: GitHub - description: Vulnerability issue tracking and management name: Issues - description: Subscription billing and plans name: Billing - description: Project management and member assignments name: Projects - description: SSH key pair generation and management for remote server access name: SSH Keys - description: Codebase structural analysis and mapping name: Codemaps - description: AI-generated codebase documentation and security analysis name: CodeWiki - description: Captured HTTP traffic query and replay name: Network Events - description: User and team API activity metadata name: Audit Logs - description: Vulnerability triage for HackerOne, GitHub, and Security Inbox name: Triage paths: /api/v1/billing/invoices: get: tags: - Billing summary: List billing invoices description: | Returns a list of Stripe invoices for the authenticated user's Stripe customer. Includes all credit purchase invoices. operationId: get-v1-billing-invoices parameters: - description: Maximum number of invoices to return (default 25, max 100) in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer - description: Cursor for pagination - Stripe invoice ID to start after in: query name: starting_after required: false schema: type: string - description: Filter by invoice type; omit to return all in: query name: type required: false schema: enum: - purchase - topup - subscription type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/BillingInvoiceHistoryResponse' description: List of invoices with credit context and lifetime totals '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad request - no subscription found '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden - team admin role required '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: BillingInvoiceHistoryResponse: properties: currency: description: >- Currency code aggregated across credit purchases (defaults to "usd"). type: string has_more: description: Whether more invoices exist beyond this page. type: boolean invoice_history: description: | All Stripe invoices for the authenticated user's Stripe customer, enriched per-row with credit context when a matching local credit_purchase event exists. items: $ref: '#/components/schemas/BillingInvoice' type: array total_amount_cents: description: Lifetime total spent in cents across credit purchases. format: int64 type: integer total_amount_display: description: Formatted lifetime total (e.g. "$1,250.00"). type: string total_purchases: description: Lifetime count of credit_purchase events for this resource. type: integer required: - invoice_history - has_more - total_purchases - total_amount_cents - total_amount_display - currency type: object ErrorResponse: properties: code: description: > Stable machine-readable error code — branch on this rather than matching the human `error`/`message` strings. `access_restricted` (HTTP 403) denies hosted Neo access under the access policy. On team invitations, param=email identifies a restricted recipient rather than the caller; show the error without redirecting the caller. Domain codes include `user_spending_cap_reached`, `project_spending_cap_reached`, and `insufficient_neo_credits`; Free/usage codes include `free_grant_challenge_required`, `free_usage_exhausted`, `free_task_budget_exhausted`, `model_not_available_on_free`, `sandbox_not_available_on_free` (cloud sandbox surfaces are not available on the Free plan; task files remain available from the task), `free_cannot_continue_managed_task` (a task that ran on the standard cloud sandbox cannot be continued on the Free plan; start a new task), `free_origin_not_supported` (integration-originated tasks are not available on the Free plan), `weekly_usage_limit_reached`, `billing_period_usage_limit_reached`, `topup_required`, `subscription_required`, and `isolated_workspace_purged`. Otherwise it mirrors the error kind (e.g. `forbidden`, `invalid_request`, `not_exists`, `already_exists`). example: user_spending_cap_reached type: string error: example: Bad request type: string error_id: description: Correlation id for a specific error instance, when present. type: string kind: description: Coarse error category (e.g. "forbidden request", "invalid request"). example: forbidden request type: string message: description: | Human-readable detail (the kind prefixed to the error). For display, not for branching. type: string param: description: >- Field rejected by the policy; email for a restricted invite recipient. type: string turnstile_site_key: description: | Public Cloudflare Turnstile site key returned only with `free_grant_challenge_required`, so the client can complete the invisible verification before retrying the request. type: string required: - error type: object BillingInvoice: properties: amount_cents: description: Amount in cents type: integer amount_display: description: Formatted amount (e.g. "$500.00") type: string base_subscription_credits: description: | Base subscription credits at the billed tier (1x) for this invoice, before any first-month bonus. format: double type: number created_at: format: date-time type: string currency: type: string description: type: string discount_credits: description: > First-month bonus credits granted on this subscription invoice (the portion above the billed tier). Present only on subscription invoices that carried a bonus. format: double type: number discount_multiplier: description: > Multiplier applied to the per-seat grant for the first-month bonus (e.g. 2). Present only on subscription invoices that carried a bonus. format: double type: number granted_subscription_credits: description: > Total subscription credits granted on this invoice (base + discount). format: double type: number id: description: Stripe Invoice ID type: string invoice_pdf: description: URL to download invoice PDF type: string invoice_url: description: Stripe hosted invoice URL type: string new_issued_credits: description: > Issued credits after this purchase was applied (remaining_before_purchase + purchased_credits). format: double type: number paid_at: format: date-time type: string purchased_credits: description: | Credits purchased on this invoice, sourced from neo_credit_history. Null when the invoice predates Stripe identifier capture or no matching credit_purchase row exists. format: double type: number remaining_before_purchase: description: | Available credit balance immediately before this purchase was applied (snapshot value used when stamping the new issued total). format: double type: number status: description: Payment status (paid, open, draft, void, uncollectible) type: string type: description: Invoice type enum: - purchase - topup - subscription type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT authentication token scheme: bearer type: http ApiKeyAuth: description: Neo API key (neo_sk_* prefix) in: header name: X-Api-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.