> ## Documentation Index
> Fetch the complete documentation index at: https://developers.everhour.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Invoice

> Retrieve a single invoice with its full line-item breakdown.



## OpenAPI

````yaml /openapi.json get /invoices/{invoice_id}
openapi: 3.1.1
info:
  title: Everhour API
  version: 1.0.0
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
  - url: https://api.everhour.com
security:
  - ApiKeyAuth: []
tags:
  - name: Clients
  - name: Custom Fields
  - name: Expenses
  - name: Invoices
  - name: Projects
  - name: Reports
  - name: Schedule
  - name: Tasks
  - name: Time Off
  - name: Time Records
  - name: Timecards
  - name: Timers
  - name: Timesheets
  - name: Users
  - name: Webhooks
paths:
  /invoices/{invoice_id}:
    get:
      tags:
        - Invoices
      summary: Get Invoice
      description: Retrieve a single invoice with its full line-item breakdown.
      operationId: getInvoice
      parameters:
        - name: invoice_id
          in: path
          required: true
          description: Invoice ID
          schema:
            type: number
            example: 11903
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Invoice'
        '401':
          description: Unauthorized
components:
  schemas:
    Invoice:
      type: object
      properties:
        id:
          type: number
          description: Invoice ID
          example: 2660155
        client:
          $ref: '#/components/schemas/Client'
        createdAt:
          type: string
          example: '2018-01-16 12:42:59'
        createdBy:
          $ref: '#/components/schemas/User'
        dateFrom:
          type: string
        dateTill:
          type: string
        dueDate:
          type: string
        discount:
          type: object
          properties:
            amount:
              type: number
              example: 4581
            rate:
              type: number
              example: 25
        expenseMask:
          type: string
          example: '%PROJECT% :: %CATEGORY%'
        includeExpenses:
          type: boolean
          example: true
        includeTime:
          type: boolean
          example: true
        invoiceItems:
          type: array
          items:
            $ref: '#/components/schemas/InvoiceItem'
        issueDate:
          type: string
          example: '2019-03-22'
        limitDateFrom:
          type: string
        limitDateTill:
          type: string
        listAmount:
          type: number
          description: List amount in cents (without discount and taxes)
          example: 18325
        netAmount:
          type: number
          description: Net amount in cents (without taxes but with discount applied)
          example: 13744
        projects:
          type: array
          items:
            type: string
          example:
            - gh:63301595
        publicId:
          type: string
          example: '1020'
        status:
          type: string
          enum:
            - draft
            - sent
            - paid
            - deleted
            - partial
          example: draft
        tax:
          type: object
          properties:
            id:
              type: integer
              description: >-
                Tax ID from a connected accounting integration (external
                invoices).
            rate:
              type: number
              example: 11
            amount:
              type: number
              example: 1512
        timeMask:
          type: string
          example: '%PROJECT%'
        totalAmount:
          type: number
          description: Total invoice amount in cents (with discount and taxes applied)
          example: 15256
        totalTime:
          type: number
          description: Total invoice time in seconds
          example: 43980
        valid:
          type: boolean
          example: true
      required:
        - id
        - client
        - createdAt
        - createdBy
        - status
    Client:
      type: object
      properties:
        id:
          type: number
          example: 4567
        name:
          type: string
          example: Client Name
        projects:
          type: array
          description: List of projects ID
          items:
            type: string
          example:
            - ev:1234567890
        businessDetails:
          type:
            - string
            - 'null'
        budget:
          $ref: '#/components/schemas/ClientBudget'
      required:
        - id
        - name
        - projects
    User:
      type: object
      properties:
        id:
          type: number
          example: 1304
        name:
          type: string
          example: User Name
        headline:
          type:
            - string
            - 'null'
          example: CEO
        avatarUrl:
          type:
            - string
            - 'null'
        role:
          type: string
          enum:
            - admin
            - supervisor
            - member
            - member_limited
          example: admin
        status:
          type: string
          enum:
            - active
            - invited
            - pending
            - removed
          example: active
        phone:
          type: string
          nullable: true
        capacity:
          type: integer
          nullable: true
          description: Weekly capacity in seconds.
        avatarUrlLarge:
          type: string
          nullable: true
      required:
        - id
        - name
        - role
        - status
    InvoiceItem:
      type: object
      properties:
        billedTime:
          type: number
          description: Time in seconds
          example: 415860
        createdAt:
          type: string
          example: '2017-02-22 16:11:33'
        custom:
          type: boolean
          example: false
        id:
          type: number
          example: 52
        listAmount:
          type: number
          description: Amount in cents
          example: 288793
        name:
          type: string
          example: Software Development
        netAmount:
          type: number
          description: Amount in cents
          example: 288793
        position:
          type: number
          example: 1
        taxable:
          type: number
          example: 1
        totalAmount:
          type: number
          example: 288793
    ClientBudget:
      type: object
      properties:
        type:
          type: string
          description: Budget Type
          enum:
            - money
            - time
            - costs
          example: money
        budget:
          type: number
          description: Budget value in cents (for money) or seconds (for time)
          example: 100000
        period:
          type: string
          description: Budget periodicity (overall, monthly, weekly, daily)
          enum:
            - general
            - monthly
            - weekly
            - daily
            - quarterly
            - yearly
          example: general
        appliedFrom:
          type:
            - string
            - 'null'
          description: Start budget from (available only for non-recurrent budgets)
        disallowOverbudget:
          type: boolean
        excludeUnbillableTime:
          type: boolean
        excludeExpenses:
          type: boolean
        threshold:
          type: number
          description: >-
            Email admins when threshold reached. Threshold is percentage 1 -
            100.
        progress:
          type: number
          description: Current budget usage in cents (for money) or seconds (for time)
          readOnly: true
          example: 0
      required:
        - type
        - budget
        - period
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````