> ## Documentation Index > Fetch the complete documentation index at: https://developers.liara.ir/llms.txt > Use this file to discover all available pages before exploring further. # Get a monthly invoice > Returns a monthly billing invoice with its line items. With `teamID`, this needs the `billing.manage` permission. ## OpenAPI ````yaml /spec/platform-billing.yaml get /v1/billing-invoices/{billingInvoiceID} openapi: 3.0.1 info: title: Billing & Subscription version: 1.0.0 description: | Check your balance and costs, add credit, download invoices and receipts, manage your subscription plan, and apply discount codes. All amounts are in Toman (IRT). With `teamID`, these endpoints work on the team's billing. Most of them need the `billing.manage` permission in the team; the description of each endpoint says which permission it needs. servers: - url: https://api.liara.ir security: - bearerAuth: [] tags: - name: Balance & Usage description: Balance, current costs and service counts. - name: Payments description: Add credit and list past payments. - name: Invoices & Receipts description: Monthly billing invoices and payment receipts. - name: Subscription description: View and change the account's subscription plan. - name: Discount Codes description: Check and apply discount codes. paths: /v1/billing-invoices/{billingInvoiceID}: get: tags: - Invoices & Receipts summary: Get a monthly invoice description: >- Returns a monthly billing invoice with its line items. With `teamID`, this needs the `billing.manage` permission. operationId: getBillingInvoice parameters: - $ref: '#/components/parameters/TeamID' - name: billingInvoiceID in: path required: true schema: $ref: '#/components/schemas/ObjectID' responses: '200': description: The invoice. content: application/json: schema: type: object properties: billingInvoice: $ref: '#/components/schemas/BillingInvoice' example: billingInvoice: _id: '000000000000000000000070' user: '000000000000000000000001' invoiceNumber: 1000 accountType: REAL_PERSON totalAmount: 180000 totalTaxAmount: 18000 jalaliDateAt: '1405-01-01T00:00:00.000Z' items: - code: name: پلتفرم لیارا quantity: 1 unit: عدد taxPercentage: 0.1 pricePerUnit: 180000 taxPricePerUnit: 18000 vendorInfo: name: customerInfo: firstName: نام lastName: نام خانوادگی createdAt: '2026-03-21T00:00:00.000Z' updatedAt: '2026-03-21T00:00:00.000Z' '400': $ref: '#/components/responses/ValidationOrTeamIDError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/TeamForbidden' '404': description: No invoice with this ID. content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 404 error: Not Found message: no_invoice data: null components: parameters: TeamID: name: teamID in: query required: false description: >- Run the request in the context of a team you belong to, instead of your personal account. schema: $ref: '#/components/schemas/ObjectID' example: '000000000000000000000002' schemas: ObjectID: type: string pattern: ^[0-9a-fA-F]{24}$ description: 24-character hexadecimal ID. BillingInvoice: allOf: - $ref: '#/components/schemas/BillingInvoiceSummary' - type: object properties: items: type: array items: type: object properties: code: type: string description: Product code of the line item. name: type: string quantity: type: number unit: type: string taxPercentage: type: number pricePerUnit: type: number taxPricePerUnit: type: number vendorInfo: type: object description: Seller details. customerInfo: type: object description: Your billing contact details when the invoice was issued. Error: type: object description: Standard error body. properties: statusCode: type: integer error: type: string description: HTTP status text. message: type: string description: What went wrong. data: type: object nullable: true description: >- Extra details. When present, `code` is a stable, machine-readable error code. properties: code: type: string BillingInvoiceSummary: type: object properties: _id: type: string user: type: string accountType: type: string enum: - REAL_PERSON - LEGAL_PERSON totalAmount: type: number totalTaxAmount: type: number jalaliDateAt: type: string description: >- Solar Hijri date (`YYYY-MM-DD`) of the first day of the month the invoice was issued. It covers the previous month. invoiceNumber: type: integer createdAt: type: string format: date-time updatedAt: type: string format: date-time AuthError: type: object description: Error body returned when the API token is rejected. properties: error: type: string responses: ValidationOrTeamIDError: description: >- A parameter or the body is invalid (`message` says which), or `teamID` isn't a valid ID. content: application/json: schema: $ref: '#/components/schemas/Error' examples: validation: summary: Invalid parameter value: statusCode: 400 error: Bad Request message: '"count" must be greater than or equal to 1' invalidTeamID: summary: Invalid team ID value: statusCode: 400 error: Bad Request message: Invalid team ID. data: null Unauthorized: description: The API token is missing, invalid or expired. content: application/json: schema: $ref: '#/components/schemas/AuthError' example: error: Unauthorized. TeamForbidden: description: >- With `teamID`: you aren't a member of the team (`team_not_found`), or your role doesn't have the required permission (`no_permission`). content: application/json: schema: $ref: '#/components/schemas/Error' examples: teamNotFound: summary: Not a team member value: statusCode: 403 error: Forbidden message: Team not found data: code: team_not_found noPermission: summary: Missing permission value: statusCode: 403 error: Forbidden message: You do not have permission to access this resource. data: code: no_permission securitySchemes: bearerAuth: type: http scheme: bearer description: 'Send your API token as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.