> ## Documentation Index > Fetch the complete documentation index at: https://doubledata.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List invoices > List your organization's invoices, newest first. Draft invoices are not included. ## OpenAPI ````yaml /openapi.json get /invoices openapi: 3.1.0 info: title: DoubleData Proxy API version: 1.2.0 description: >- Manage proxy usage, wallet balance, orders, subscriptions, rotations, and IP authorization. Your API key selects the workspace; do not send an organization ID. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://app.proxy.doubledata.com/api/v1 description: Production security: - bearerAuth: [] tags: - name: Stats & usage description: >- Date-range bandwidth, request counts, and actual wallet usage charges for your proxy credentials. - name: Balance description: The organization USD balance shared with the DoubleData website. - name: Catalog description: Static ISP tiers and cached country availability. - name: Orders description: Server-priced wallet orders and asynchronous provisioning. - name: Subscriptions description: Active Static ISP subscriptions and their connection records. - name: Rotations description: Asynchronous selected-IP rotation batches. - name: IP authorization description: The source IP authorized for a subscription. - name: Credentials description: >- Residential, datacenter, and mobile proxy credentials and their traffic limits. - name: Invoices description: Organization invoices and invoice PDF downloads. paths: /invoices: get: tags: - Invoices summary: List invoices description: >- List your organization's invoices, newest first. Draft invoices are not included. operationId: listInvoices parameters: - name: limit in: query required: false description: Page size. schema: type: integer minimum: 1 maximum: 100 default: 25 - name: starting_after in: query required: false description: >- Return invoices after this invoice ID. Use `next_cursor` from the previous page. schema: type: string pattern: ^in_[A-Za-z0-9]+$ - name: status in: query required: false description: Only return invoices with this status. schema: type: string enum: - open - paid - void - uncollectible responses: '200': description: A page of invoices headers: X-Request-ID: $ref: '#/components/headers/RequestID' Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/InvoicesResponse' examples: example: value: invoices: - id: in_1QxY2zAbCdEfGh number: DD-2026-0042 status: paid description: Residential traffic currency: usd total_cents: 5000 amount_paid_cents: 5000 amount_due_cents: 0 created_at: '2026-11-01T10:00:00Z' paid_at: '2026-11-01T10:00:05Z' hosted_invoice_url: https://invoice.stripe.com/i/acct_example/live_example pdf_available: true has_more: false next_cursor: null '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/ServiceUnavailable' components: headers: RequestID: description: A request UUID to include when contacting support. schema: type: string format: uuid CacheControl: description: Responses are not stored in shared or browser caches. schema: type: string const: no-store RateLimitRetryAfter: description: When present, wait at least this many seconds before retrying. schema: type: integer minimum: 1 schemas: InvoicesResponse: type: object additionalProperties: false required: - invoices - has_more - next_cursor properties: invoices: type: array items: $ref: '#/components/schemas/Invoice' has_more: type: boolean next_cursor: type: - string - 'null' description: Pass as `starting_after` to get the next page. Invoice: type: object additionalProperties: false required: - id - number - status - description - currency - total_cents - amount_paid_cents - amount_due_cents - created_at - paid_at - hosted_invoice_url - pdf_available properties: id: type: string number: type: - string - 'null' status: type: string enum: - open - paid - void - uncollectible description: type: - string - 'null' currency: type: string example: usd total_cents: type: integer amount_paid_cents: type: integer amount_due_cents: type: integer created_at: type: string format: date-time paid_at: type: - string - 'null' format: date-time hosted_invoice_url: type: - string - 'null' format: uri description: Page where the invoice can be viewed and paid. pdf_available: type: boolean description: Whether `GET /invoices/{invoiceId}/pdf` can return a PDF. ErrorResponse: type: object additionalProperties: false required: - error properties: error: $ref: '#/components/schemas/Error' Error: type: object additionalProperties: false required: - code - message - request_id properties: code: type: string enum: - invalid_request - invalid_ip_address - invalid_proxy_ip - duplicate_proxy_ip - unknown_proxy_ip - invalid_package - insufficient_balance - quote_expired - request_conflict - kyc_required - rotation_allowance_exhausted - rotation_in_progress - unauthorized - forbidden - not_found - not_available - rate_limit_exceeded - temporarily_unavailable - internal_error message: type: string minLength: 1 details: $ref: '#/components/schemas/ErrorDetails' request_id: type: string format: uuid ErrorDetails: type: object additionalProperties: false properties: ips: type: array maxItems: 100 items: type: string format: ipv4 responses: BadRequest: description: Invalid ID, request body, or selected IPs. headers: X-Request-ID: $ref: '#/components/headers/RequestID' Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unknownIP: value: error: code: unknown_proxy_ip message: One or more IPs are not active in this subscription. details: ips: - 198.51.100.10 request_id: ad2f824c-46bc-47c6-b276-2bb51a3083b1 Unauthorized: description: The API key is missing, invalid, or revoked. headers: X-Request-ID: $ref: '#/components/headers/RequestID' Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: value: error: code: unauthorized message: A valid API key is required. request_id: ad2f824c-46bc-47c6-b276-2bb51a3083b1 TooManyRequests: description: Request limit or rotation allowance reached. headers: Retry-After: $ref: '#/components/headers/RateLimitRetryAfter' X-Request-ID: $ref: '#/components/headers/RequestID' Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalError: description: The request could not be completed. headers: X-Request-ID: $ref: '#/components/headers/RequestID' Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ServiceUnavailable: description: The API is temporarily unavailable. headers: X-Request-ID: $ref: '#/components/headers/RequestID' Cache-Control: $ref: '#/components/headers/CacheControl' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: Your organization's active API key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.