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

# List invoices ready to send

> Retrieve a paginated list of customer invoices in the Pre-Invoice Audit Ready To Send queue. Returns CREATED invoices that are not on hold, have a customer, have no open exceptions, are not scheduled, are not manual portal work, and may have approvedToSend either true or false.



## OpenAPI

````yaml /api-reference/openapi.json get /api/rest/invoices/queues/ready-to-send
openapi: 3.1.0
info:
  description: >-
    Upwell is Accounts Receivable automation software for the logistics
    industry. We serve freight brokers, carriers, factors, and anyone who needs
    to get transportation invoices paid.


    Learn more at:


    - [Upwell.com](https://upwell.com)
  title: Upwell REST API
  version: 3.28.3
  termsOfService: https://upwell.com/legal
  contact:
    name: Upwell
    url: https://upwell.com
    email: contact@upwell.com
servers:
  - url: https://api.upwell.com
    description: Production server
  - url: https://staging.api.upwell.com
    description: Staging server
security: []
tags:
  - name: Invoice Approval
    description: Endpoints for managing customer invoice approval workflow
paths:
  /api/rest/invoices/queues/ready-to-send:
    get:
      tags:
        - Invoice Approval
      summary: List invoices ready to send
      description: >-
        Retrieve a paginated list of customer invoices in the Pre-Invoice Audit
        Ready To Send queue. Returns CREATED invoices that are not on hold, have
        a customer, have no open exceptions, are not scheduled, are not manual
        portal work, and may have approvedToSend either true or false.
      parameters:
        - description: Your API key for authentication
          in: header
          name: authorization
          schema:
            type: string
        - in: query
          name: limit
          schema:
            default: 10
            type: integer
          description: Maximum number of invoices to return
        - in: query
          name: offset
          schema:
            default: 0
            type: integer
          description: Number of invoices to skip for pagination
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  invoices:
                    items:
                      description: Invoice details
                      nullable: false
                      properties:
                        approvedToSend:
                          nullable: true
                          title: Boolean
                          type: boolean
                          description: Whether the invoice has been approved to send
                        createdAt:
                          $ref: '#/components/schemas/timestamptz'
                          description: Timestamp when the invoice was created
                          type: string
                          format: date-time
                        customer:
                          description: Customer associated with the invoice
                          nullable: true
                          properties:
                            id:
                              nullable: false
                              title: String
                              type: string
                              description: Customer unique identifier
                            name:
                              nullable: true
                              title: String
                              type: string
                              description: Customer name
                          title: Customers
                          type: object
                        customerId:
                          nullable: true
                          title: String
                          type: string
                          description: ID of the customer
                        holdForReview:
                          nullable: false
                          title: Boolean
                          type: boolean
                          description: Whether the invoice is currently on hold for review
                        id:
                          nullable: false
                          title: String
                          type: string
                          description: Invoice unique identifier
                        issueDate:
                          $ref: '#/components/schemas/date'
                          description: Date the invoice was issued
                          type: string
                          format: date
                        number:
                          nullable: false
                          title: String
                          type: string
                          description: Invoice number
                        status:
                          $ref: '#/components/schemas/InvoiceStatusEnum'
                          description: Current status of the invoice
                          type: string
                        totalAmount:
                          $ref: '#/components/schemas/bigint'
                          description: Total amount of the invoice in cents
                          type: integer
                      title: Invoices
                      type: object
                    nullable: false
                    type: array
                    description: Array of invoices ready to send
                  invoicesAggregate:
                    description: Aggregate information about the query results
                    nullable: false
                    properties:
                      aggregate:
                        description: Aggregate counts
                        nullable: true
                        properties:
                          count:
                            nullable: false
                            title: Int
                            type: integer
                            description: Total number of invoices matching the query
                        title: InvoicesAggregateFields
                        type: object
                    title: InvoicesAggregate
                    type: object
                type: object
          description: List of invoices ready to send
components:
  schemas:
    timestamptz:
      nullable: false
      title: timestamptz
      type: string
      format: date-time
      description: >-
        A timestamp with timezone in ISO 8601 format, such as
        2024-12-16T21:57:14.525733+00:00
    date:
      nullable: false
      title: date
      type: string
      format: date
      description: A date string, such as 2024-02-03 (YYYY-MM-DD)
    InvoiceStatusEnum:
      enum:
        - APPROVED
        - CANCELLED
        - CREATED
        - DELIVERED
        - DISPUTED
        - OPEN
        - OVERDUE
        - PAID
        - PART_PAID
        - PORTAL_EXCEPTION
        - PORTAL_RESOLVED
        - PROCESSING
        - REFUNDED
        - REJECTED
        - SEND_ERROR
        - SENT
        - VIEWED
        - WRITE_OFF
      nullable: false
      title: InvoiceStatusEnum
    bigint:
      nullable: false
      title: bigint

````