fulfillment_invoices

Fetch fulfillment invoices matching the supplied arguments.

Arguments

Argument	Type	Required	Description
`date_from`	ISODateTime	No	Inclusive start of the date range, in ISO-8601 datetime format.
`date_to`	ISODateTime	No	Inclusive end of the date range, in ISO-8601 datetime format.
`analyze`	`Boolean`	No	If true, the query will only be analyzed (cost estimated) without executing it.

Return Type

FulfillmentInvoicesQueryResult

Query

query fulfillment_invoices(
  $date_from: ISODateTime,
  $date_to: ISODateTime,
  $analyze: Boolean
) {
  fulfillment_invoices(
    date_from: $date_from,
    date_to: $date_to,
    analyze: $analyze
  ) {
    request_id
    complexity
    data {
      ...FulfillmentInvoiceConnectionFragment
    
      pageInfo {
        ...PageInfoFragment
      
        hasNextPage
        hasPreviousPage
        startCursor
        endCursor
      }
      edges {
        ...FulfillmentInvoiceEdgeFragment
      
        node {
          ...FulfillmentInvoiceFragment
        
          id
          legacy_id
          stripe_charge_id
          stripe_invoice_id
          stripe_invoice_number
          stripe_invoice_status
          stripe_invoice_url
          stripe_next_payment_attempt
          account_id
          cc_info
          amount
          created_at
          shipping_items {
            ...FulfillmentInvoiceShippingItemConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...FulfillmentInvoiceShippingItemEdgeFragment
            
              node {
                ...FulfillmentInvoiceShippingItemFragment
              
                id
                legacy_id
                account_id
                invoice_id
                order_id
                shipment_id
                shipping_label_id
                amount
                shipping_rate
                processing_fee
                picking_fee
                overcharge_fee
                created_at
              }
              cursor
            }
          }
          inbound_shipping_items {
            ...FulfillmentInvoiceInboundShippingItemConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...FulfillmentInvoiceInboundShippingItemEdgeFragment
            
              node {
                ...FulfillmentInvoiceInboundShippingItemFragment
              
                id
                legacy_id
                account_id
                invoice_id
                purchase_order_id
                shipment_id
                shipping_label_id
                amount
                cost
                created_at
              }
              cursor
            }
          }
          returns_items {
            ...FulfillmentInvoiceReturnItemConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...FulfillmentInvoiceReturnItemEdgeFragment
            
              node {
                ...FulfillmentInvoiceReturnItemFragment
              
                id
                legacy_id
                account_id
                invoice_id
                order_id
                rma_id
                rma_label_id
                amount
                shipping_rate
                picking_fee
                inspection_fee
                restocking_fee
                created_at
              }
              cursor
            }
          }
          returns_fulfillment_items {
            ...FulfillmentInvoiceReturnFulfillmentItemConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...FulfillmentInvoiceReturnFulfillmentItemEdgeFragment
            
              node {
                ...FulfillmentInvoiceReturnFulfillmentItemFragment
              
                id
                legacy_id
                account_id
                invoice_id
                order_id
                rma_id
                rma_label_id
                amount
                sub_total_amount
                picking_fee
                inspection_fee
                restocking_fee
                fulfillment_taxes
                created_at
              }
              cursor
            }
          }
          storage_items {
            ...FulfillmentInvoiceStorageItemConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...FulfillmentInvoiceStorageItemEdgeFragment
            
              node {
                ...FulfillmentInvoiceStorageItemFragment
              
                id
                legacy_id
                account_id
                warehouse_id
                invoice_id
                amount
                created_at
              }
              cursor
            }
          }
        }
        cursor
      }
    }
  }
}

Variables

{
  "date_from": "2026-07-09T15:30:00Z",
  "date_to": "2026-07-09T15:30:00Z",
  "analyze": true
}

Response

{
  "data": {
    "fulfillment_invoices": {
      "request_id": "UmVjb3JkOjEyMzQ=",
      "complexity": 100,
      "data": [{id: "RnVsZmlsbG1lbnRJbnZvaWNlOjEyMzQ="}]
    }
  }
}