> ## Documentation Index
> Fetch the complete documentation index at: https://billing-docs.platform.ai71services.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get invoice by ID

> Retrieve details of a specific invoice.



## OpenAPI

````yaml specs/billing_api_docs.json get /api/v1/invoices/{id}
openapi: 3.0.1
info:
  title: Billing API
  description: Billing service for managing subscriptions, payments, and entitlements
  contact: {}
  version: '1.0'
servers:
  - url: https://dev-billing-api.iqraa.ai/api/v1
security: []
tags:
  - name: Customers
    description: Customers related endpoints
  - name: Subscriptions
    description: Subscription related endpoints
  - name: Plans
    description: Plans related endpoints
  - name: Entitlements
    description: Entitlements related endpoints
  - name: Payments
    description: Payments related endpoints
  - name: Emails
    description: Email related endpoints
paths:
  /api/v1/invoices/{id}:
    get:
      tags:
        - Invoices
      summary: Get invoice by ID
      description: Retrieve details of a specific invoice.
      operationId: InvoicesController_getInvoice
      parameters:
        - name: id
          required: true
          in: path
          description: Invoice ID
          schema:
            type: string
        - name: X-Preferred-Language
          required: true
          in: header
          description: Language for invoice fields
          schema:
            enum:
              - ar
              - en
            type: string
      responses:
        '200':
          description: Invoice details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvoiceResponseDto'
        '403':
          description: Forbidden - Customer ID is missing or invalid
        '404':
          description: Invoice not found
      security:
        - bearer: []
components:
  schemas:
    InvoiceResponseDto:
      type: object
      properties:
        id:
          type: string
        invoiceNumber:
          type: string
        date:
          type: string
        status:
          type: string
          enum:
            - DRAFT
            - FINALIZED
            - PAYMENT_FAILED
            - PAID
            - VOID
        amount:
          type: number
        currency:
          type: string
        description:
          type: string
        downloadLink:
          type: string
        planType:
          type: string
        customerName:
          type: string
        customerEmail:
          type: string
      required:
        - id
        - invoiceNumber
        - date
        - status
        - amount
        - currency
        - description
        - customerName
        - customerEmail
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: opaque
      type: http

````