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

# Get Invoice



## OpenAPI

````yaml /api-reference/manexx-merchant-api.json get /api/v1/external/invoices/{ident}
openapi: 3.0.3
info:
  title: Manexx Merchant API
  version: 0.1.0
  description: Public merchant integration API (X-Api-Key).
servers:
  - url: https://api.manexx.com
security: []
tags:
  - name: Merchant API
    description: Merchant API
paths:
  /api/v1/external/invoices/{ident}:
    get:
      tags:
        - Merchant API
      summary: Get Invoice
      operationId: get_invoice_api_v1_external_invoices__ident__get
      parameters:
        - name: ident
          in: path
          required: true
          schema:
            type: string
            title: Ident
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Success_InvoiceExternalRead_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    Success_InvoiceExternalRead_:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        data:
          $ref: '#/components/schemas/InvoiceExternalRead'
      type: object
      required:
        - data
      title: Success[InvoiceExternalRead]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    InvoiceExternalRead:
      properties:
        uuid:
          type: string
          format: uuid
          title: Uuid
          description: Our order id.
          example: 9f2c1e5a-3b7d-4e21-a0c9-1f2e3d4c5b6a
        external_id:
          type: string
          title: External Id
          description: Your order id.
          example: order-4821
        customer_id:
          type: string
          title: Customer Id
          description: Your customer id.
          example: user-99
        purpose:
          title: Purpose
          nullable: true
          type: string
          example: 'Order #4821'
        amount:
          type: string
          title: Amount
          description: Base order amount in fiat (unchanged).
          example: '1050.00'
        amount_to_send:
          title: Amount To Send
          description: >-
            Amount the customer pays (with commission). Null until a method is
            chosen.
          nullable: true
          type: string
          example: '1071.00'
        currency:
          $ref: '#/components/schemas/CurrencyShort'
        status:
          $ref: '#/components/schemas/MerchantInvoiceStatus'
          example: success
        callback_url:
          title: Callback Url
          nullable: true
          type: string
          example: https://shop.example/webhooks/manexx
        success_url:
          title: Success Url
          nullable: true
          type: string
          example: https://shop.example/paid
        fail_url:
          title: Fail Url
          nullable: true
          type: string
          example: https://shop.example/failed
        payment_url:
          type: string
          title: Payment Url
          description: Hosted payment link.
          example: https://pay.manexx.com/pay/9f2c1e5a-...?token=...
        created_at:
          type: string
          format: date-time
          title: Created At
          example: '2026-07-16T09:24:11Z'
        expires_at:
          type: string
          format: date-time
          title: Expires At
          example: '2026-07-16T09:39:11Z'
        finished_at:
          title: Finished At
          description: When the invoice reached a terminal state.
          nullable: true
          type: string
          format: date-time
          example: '2026-07-16T09:33:02Z'
        payment_method:
          description: Method the customer chose. Null until selected.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaymentMethodBrief'
        rate:
          title: Rate
          description: Fiat-per-USDT rate snapshot.
          nullable: true
          type: string
          example: '41.20'
        settled_amount_usdt:
          title: Settled Amount Usdt
          description: USDT credited to you. Populated only on success.
          nullable: true
          type: string
          example: '24.80'
        is_adjusted:
          type: boolean
          title: Is Adjusted
          description: Whether the paid amount was corrected during a dispute.
          example: false
        adjustment:
          description: Present only when is_adjusted is true.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/InvoiceAdjustment'
      type: object
      required:
        - uuid
        - external_id
        - customer_id
        - amount
        - currency
        - status
        - payment_url
        - created_at
        - expires_at
        - is_adjusted
      title: InvoiceExternalRead
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    CurrencyShort:
      properties:
        id:
          type: integer
          title: Id
          example: 1
        code:
          type: string
          title: Code
          description: Currency code.
          example: UAH
        name:
          type: string
          title: Name
          description: Currency name.
          example: Ukrainian hryvnia
        symbol:
          type: string
          title: Symbol
          description: Currency symbol.
          example: ₴
      type: object
      required:
        - id
        - code
        - name
        - symbol
      title: CurrencyShort
    MerchantInvoiceStatus:
      type: string
      enum:
        - pending
        - success
        - fail
        - expired
        - canceled
      title: MerchantInvoiceStatus
    PaymentMethodBrief:
      properties:
        name:
          type: string
          title: Name
          description: Payment method name.
          example: Monobank
        logo_url:
          title: Logo Url
          description: Method logo URL.
          nullable: true
          type: string
          example: https://cdn.manexx.com/methods/monobank.png
      type: object
      required:
        - name
      title: PaymentMethodBrief
    InvoiceAdjustment:
      properties:
        expected_amount_fiat:
          type: string
          title: Expected Amount Fiat
          description: Fiat you originally ordered.
          example: '1050.00'
        actual_amount_fiat:
          type: string
          title: Actual Amount Fiat
          description: Fiat actually paid.
          example: '1000.00'
        expected_amount_usdt:
          type: string
          title: Expected Amount Usdt
          description: USDT expected at the ordered amount.
          example: '26.05'
        actual_amount_usdt:
          type: string
          title: Actual Amount Usdt
          description: USDT actually credited.
          example: '24.80'
      type: object
      required:
        - expected_amount_fiat
        - actual_amount_fiat
        - expected_amount_usdt
        - actual_amount_usdt
      title: InvoiceAdjustment
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key

````