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

# Get Fintech Invoices

> Returns high-level billing summaries by brand, as configured in Settings > Fintech Setup. Not paginated.



## OpenAPI

````yaml /openapi.json get /api/v1/fintech/invoices
openapi: 3.0.0
info:
  title: Authentication API
  description: API for user authentication and token generation
  version: 1.0.0
servers:
  - url: https://api.retailreadyai.com
    description: Production server
  - url: https://stg.retailreadyai.com
    description: Staging server
security: []
paths:
  /api/v1/fintech/invoices:
    get:
      tags:
        - Fintech
      summary: Get Fintech Invoices
      description: >-
        Returns high-level billing summaries by brand, as configured in Settings
        > Fintech Setup. Not paginated.
      parameters:
        - name: brand_id
          in: query
          schema:
            type: string
          description: Filter to a single brand.
        - name: retailer_id
          in: query
          schema:
            type: string
          description: Filter to a single retailer.
        - name: transportation_method
          in: query
          schema:
            type: string
            enum:
              - FREIGHT
              - PARCEL
          description: Filter by transportation method.
        - name: order_completed_at_start
          in: query
          schema:
            type: string
            format: date
          description: >-
            Lower bound (inclusive) on order completion (ASN sent). Every date
            bound is optional and independent.
        - name: order_completed_at_end
          in: query
          schema:
            type: string
            format: date
          description: Upper bound (inclusive) on order completion (ASN sent).
        - name: order_packed_at_start
          in: query
          schema:
            type: string
            format: date
          description: Lower bound (inclusive) on packed date.
        - name: order_packed_at_end
          in: query
          schema:
            type: string
            format: date
          description: Upper bound (inclusive) on packed date.
      responses:
        '200':
          description: Invoices retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Invoices retrieved successfully
                  data:
                    type: object
                    properties:
                      brands:
                        type: array
                        items:
                          type: object
                          properties:
                            brand_id:
                              type: string
                              example: brand-123
                            brand_name:
                              type: string
                              example: Acme
                            line_items:
                              type: array
                              items:
                                type: object
                                properties:
                                  metric:
                                    type: string
                                    example: Orders
                                  count:
                                    type: integer
                                    example: 42
                                  price_dollars:
                                    type: number
                                    description: >-
                                      Money is returned as float dollars, not
                                      cents.
                                    example: 84
                            action_items:
                              type: array
                              items:
                                type: object
                                properties:
                                  type:
                                    type: string
                                    example: Carton Workflow
                                  metric:
                                    type: string
                                    example: Pack
                                  count:
                                    type: integer
                                    example: 120
                                  price_dollars:
                                    type: number
                                    example: 30
                            total_price_dollars:
                              type: number
                              example: 249
                      total_price_dollars:
                        type: number
                        example: 249
              example:
                message: Invoices retrieved successfully
                data:
                  brands:
                    - brand_id: brand-123
                      brand_name: Acme
                      line_items:
                        - metric: Orders
                          count: 42
                          price_dollars: 84
                        - metric: Pallets
                          count: 10
                          price_dollars: 25
                        - metric: Cartons
                          count: 120
                          price_dollars: 60
                        - metric: Units
                          count: 2400
                          price_dollars: 0
                        - metric: SKUs
                          count: 30
                          price_dollars: 0
                        - metric: Labels Generated
                          count: 14
                          price_dollars: 7
                        - metric: Pallet Label Printed - QR Code
                          count: 10
                          price_dollars: 5
                        - metric: Pallet Label Printed - GS1 Label
                          count: 8
                          price_dollars: 4
                        - metric: Pallet Label Printed - Placard
                          count: 4
                          price_dollars: 2
                        - metric: Carton Label Printed - GS1 Label
                          count: 60
                          price_dollars: 30
                        - metric: Carton Label Printed - QR Code
                          count: 40
                          price_dollars: 20
                        - metric: Carton Label Printed - Parcel Label
                          count: 20
                          price_dollars: 10
                        - metric: VAS Actions
                          count: 15
                          price_dollars: 0
                        - metric: Packing Slips
                          count: 42
                          price_dollars: 0
                      action_items:
                        - type: Carton Workflow
                          metric: Pack
                          count: 120
                          price_dollars: 30
                      total_price_dollars: 277
                  total_price_dollars: 277
        '400':
          description: >-
            Bad request - unexpected query parameter, invalid
            transportation_method, or malformed date.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: INVALID_REQUEST
              example:
                message: >-
                  Invalid transportation_method: 'AIR'. Allowed values: FREIGHT,
                  PARCEL
                error:
                  code: INVALID_REQUEST
        '401':
          description: >-
            Unauthorized - not authenticated, or not a 3PL admin
            (lead/associate/brand users are denied).
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: UNAUTHORIZED
              example:
                message: Unauthorized
                error:
                  code: UNAUTHORIZED
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````