> ## Documentation Index > Fetch the complete documentation index at: https://guide.withvayu.com/llms.txt > Use this file to discover all available pages before exploring further. # List invoices > List invoices for the account. Optionally filter by customerId to retrieve invoices for a specific customer. ## OpenAPI ````yaml get /invoices openapi: 3.0.0 info: title: Vayu API version: 1.0.0 description: >- The Vayu API is a RESTful API that allows you to submit events for processing and storage & manage billing related entities. The API is secured using the Bearer Authentication scheme with JWT tokens. To obtain a JWT token, please contact Vayu at team@withvayu.com contact: email: dev@withvayu.com name: Vayu, Inc url: https://withvayu.com servers: - url: https://connect.withvayu.com description: Production server - url: https://staging-connect.withvayu.com description: Sandbox server security: [] tags: - name: auth description: >- The auth tag is used for endpoints related to authentication and authorization. - name: events description: The events tag is used for endpoints related to event ingestion. - name: customers description: The customers tag is used for endpoints related to customer management. - name: meters description: The meters tag is used for endpoints related to meter management. - name: contracts description: The contracts tag is used for endpoints related to contract management. - name: invoices description: The invoices tag is used for endpoints related to invoice management. - name: credits description: The credits tag is used for endpoints related to credit management. - name: webhooks description: The webhooks tag is used for endpoints related to webhook management. paths: /invoices: get: tags: - invoices summary: List invoices description: >- List invoices for the account. Optionally filter by customerId to retrieve invoices for a specific customer. operationId: listInvoices parameters: - schema: $ref: '#/components/schemas/Limit' required: false in: query name: limit - schema: $ref: '#/components/schemas/Cursor' required: false in: query name: cursor - schema: $ref: '#/components/schemas/CustomerId' required: false in: query name: customerId responses: '200': $ref: '#/components/responses/ListInvoicesResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedErrorResponse' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' security: - BearerAuthorizer: [] components: schemas: Limit: type: number minimum: 1 maximum: 1000 default: 10 Cursor: type: string CustomerId: type: string pattern: ^[0-9a-fA-F]{24}$ ValidationErrorResponse: type: object properties: type: type: string enum: - invalid_request_error code: type: string description: Specific machine-readable error code message: type: string description: Human-readable error explanation param: type: string description: Single parameter that failed validation params: type: array items: type: object properties: param: type: string description: The parameter that failed validation message: type: string description: Why validation failed for this parameter required: - param - message description: Multiple parameters that failed validation required: - type - code - message UnauthorizedErrorResponse: type: object properties: type: type: string enum: - authentication_error code: type: string enum: - authentication_failed message: type: string description: Human-readable error explanation required: - type - code - message RateLimitErrorResponse: type: object properties: type: type: string enum: - rate_limit_error code: type: string enum: - rate_limit_exceeded message: type: string description: Human-readable error explanation required: - type - code - message InternalServerErrorResponse: type: object properties: type: type: string enum: - api_error code: type: string enum: - internal_error message: type: string description: Human-readable error explanation required: - type - code - message ListInvoicesResponse: type: object properties: invoices: type: array items: type: object properties: customerId: type: string pattern: ^[0-9a-fA-F]{24}$ description: The id of the customer that the invoice is associated with contractId: type: string pattern: ^[0-9a-fA-F]{24}$ description: The id of the contract that the invoice is associated with name: type: string minLength: 1 description: >- The name of the invoice, usually a description of the billing period billingCycle: $ref: '#/components/schemas/FullDayPeriod' revenueBreakdown: type: object properties: total: type: number subtotal: type: number overage: type: number discount: type: number creditsUsed: type: number tax: type: number required: - total - subtotal - overage - discount - creditsUsed - tax description: The breakdown of the revenue for the invoice billingStatus: $ref: '#/components/schemas/InvoiceBillingStatus' paymentInfo: $ref: '#/components/schemas/PaymentInfo' dueDate: type: string nullable: true description: The due date of the invoice format: date-time accountId: type: string description: The id of the account that the invoice is associated with lineItems: type: array items: $ref: '#/components/schemas/LineItem' amount: type: number description: The total amount of the invoice id: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - customerId - name - billingCycle - revenueBreakdown - billingStatus - dueDate - accountId - lineItems - amount - id - createdAt - updatedAt total: type: number hasMore: type: boolean nextCursor: type: string required: - invoices - total - hasMore FullDayPeriod: type: object properties: startTime: type: string format: date-time endTime: type: string format: date-time required: - startTime - endTime description: The billing cycle of the invoice, consists of a start and end date InvoiceBillingStatus: type: string enum: - None - Paid - Rejected - PendingPayment - Overdue description: The billing status of the invoice PaymentInfo: type: object properties: transactionId: type: string date: type: string format: date-time paymentMethod: type: string paymentMethodId: type: string amount: type: number minimum: 0 exclusiveMinimum: true currency: $ref: '#/components/schemas/Currency' status: type: string note: type: string customerId: type: string depositTo: type: object properties: id: type: string name: type: string required: - name description: The payment information of the invoice LineItem: type: object properties: invoiceId: type: string pattern: ^[0-9a-fA-F]{24}$ description: The id of the invoice that the line item is a part of revenueBreakdown: type: object properties: total: type: number subtotal: type: number overage: type: number discount: type: number creditsUsed: type: number tax: type: number required: - total - subtotal - overage - discount - creditsUsed - tax description: The revenue breakdown of the line item required: - invoiceId - revenueBreakdown Currency: type: string nullable: true enum: - USD - EUR - GBP - ILS - CAD - AUD - COP - BRL description: The billing currency of the customer responses: ListInvoicesResponse: description: RequestSuccess content: application/json: schema: $ref: '#/components/schemas/ListInvoicesResponse' securitySchemes: BearerAuthorizer: type: http scheme: bearer bearerFormat: JWT ````