> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sezzle.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get order reports
> Get a detailed list of orders across all order types within a date range.
This endpoint is available by request only. Contact Sezzle to have your merchant account whitelisted before using it.
The maximum reportable date range is **7 days**. `end-date` must be on or after `start-date` and no more than 7 days after it.
**Sample request**
```
GET https://gateway.sezzle.com/v2/orders/report?start-date=2026-05-08&end-date=2026-05-08
```
## OpenAPI
````yaml get /v2/orders/report
openapi: 3.1.0
info:
title: Sezzle API v2
description: >-
This Sezzle API is for merchants who want to accept Sezzle as a payment
option
termsOfService: https://legal.sezzle.com
version: 2.0.0
x-logo:
url: https://media.sezzle.com/branding/2.0/png/Logo_WhiteWordmark_500x126.png
backgroundColor: '#392558'
servers:
- url: https://sandbox.gateway.sezzle.com
description: development server, usa, ca
- url: https://gateway.sezzle.com
description: production server, usa, ca
security:
- Bearer: []
externalDocs:
description: Sezzle API guides and tutorials
url: https://docs.sezzle.com/sezzle-integration
paths:
/v2/orders/report:
get:
tags:
- Reports
summary: Order Reports
description: >-
Get a detailed list of orders across all order types within a date
range.
operationId: HandleOrderReportsRequest
parameters:
- name: start-date
in: query
description: The UTC start date for the report. Must be in yyyy-mm-dd format.
required: true
schema:
type: string
format: yyyy-mm-dd
- name: end-date
in: query
description: >-
The UTC end date for the report. Must be in yyyy-mm-dd format. Must
be on or after start-date and no more than 7 days after it (maximum
reportable range: 7 days). Both start-date and end-date are
inclusive.
required: true
schema:
type: string
format: yyyy-mm-dd
responses:
'200':
description: Successful Operation
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/OrderReportItem'
example:
- created_at: '2026-04-15T14:23:08Z'
order_uuid: bm99f-31vu1-kg00e-rae1g
order_platform_uuid: 9c81f3a4-0d11-42a6-a4cc-fac81817b583
customer_name: Jane Doe
customer_email: jane.doe@example.com
external_reference_id: PO-2026-0417
customer_currency_code: USD
merchant_currency_code: USD
order_amount_in_cents: 12500
captured_amount_in_cents: 12500
uncaptured_amount_in_cents: 0
total_fees_in_cents: 750
net_amount_in_cents: 11750
refund_fee_in_cents: 0
released_amount_in_cents: 0
order_type: Standard Checkout
financing_option: 4-pay-biweekly
- created_at: '2026-04-16T09:11:42Z'
order_uuid: va13d-474s9-3000e-nungg
order_platform_uuid: a57841d8-2abb-4d64-8741-c28362d4bd92
customer_name: John Smith
customer_email: john.smith@example.com
external_reference_id: PO-2026-0418
customer_currency_code: CAD
merchant_currency_code: USD
order_amount_in_cents: 8000
captured_amount_in_cents: 5000
uncaptured_amount_in_cents: 3000
total_fees_in_cents: 480
net_amount_in_cents: 4520
refund_fee_in_cents: 0
released_amount_in_cents: 0
order_type: Virtual Card
financing_option: pay-in-full
'400':
$ref: '#/components/responses/BadRequestV2'
example:
code: bad_request
message: bad request
'401':
$ref: '#/components/responses/UnauthorizedV2'
example:
code: unauthorized
message: authorization not accepted
'404':
$ref: '#/components/responses/NotFoundV2'
example:
code: record_not_found
message: not found
components:
schemas:
OrderReportItem:
type: object
required:
- created_at
- order_uuid
- customer_currency_code
- merchant_currency_code
- order_amount_in_cents
- captured_amount_in_cents
- uncaptured_amount_in_cents
- total_fees_in_cents
- net_amount_in_cents
- order_type
properties:
created_at:
type: string
format: date-time
description: The UTC date and time the order was created.
order_uuid:
type: string
description: >-
The Sezzle-assigned order identifier. This is the same order ID
merchants see in the Merchant Dashboard, and is distinct from
order_platform_uuid (the platform-specific identifier).
order_platform_uuid:
type: string
description: The platform-specific identifier for the order.
customer_name:
type: string
description: The shopper's name as captured at checkout.
customer_email:
type: string
description: The shopper's email as captured at checkout.
external_reference_id:
type: string
description: The merchant-supplied reference for the order.
customer_currency_code:
type: string
description: The ISO-4217 currency the shopper paid in.
merchant_currency_code:
type: string
description: The ISO-4217 currency the merchant settles in.
order_amount_in_cents:
type: integer
description: The gross order amount, in cents.
captured_amount_in_cents:
type: integer
description: The amount captured against the order so far, in cents.
uncaptured_amount_in_cents:
type: integer
description: The authorized amount not yet captured, in cents.
total_fees_in_cents:
type: integer
description: The total Sezzle fees on captured amounts, in cents.
net_amount_in_cents:
type: integer
description: The captured amount minus fees and refunds, in cents.
refund_fee_in_cents:
type: integer
description: >-
The portion of fees refunded back to the merchant, in cents. Not the
order refund amount itself.
released_amount_in_cents:
type: integer
description: The authorized amount released without being captured, in cents.
order_type:
type: string
description: The display label for the order type.
enum:
- Standard Checkout
- Virtual Card
- Express Checkout
- Affiliate
- Gift Card
- Pay In Full
- Six Pay Monthly
- Four Pay Monthly
- Long Term Lending
financing_option:
type: string
description: >-
The installment plan applied to the order. Empty for order types
without an installment plan.
enum:
- 4-pay-biweekly
- 4-pay-monthly
- 6-pay-monthly
- 2-pay-biweekly
- 5-pay-biweekly
- pay-in-full
ErrorV2:
type: object
properties:
code:
type: string
description: The general error type
message:
type: string
description: A more specific error message, if available
location:
type: string
description: Where the error occurred
debug_uuid:
type: string
description: The unique identifier assigned to this error for troubleshooting
responses:
BadRequestV2:
description: Invalid request
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ErrorV2'
example:
- code: bad_request
message: bad request
UnauthorizedV2:
description: >-
Unauthorized. Returned for any failed bearer or basic auth, including
expired bearer tokens.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ErrorV2'
example:
- code: unauthorized
message: authorization not accepted
NotFoundV2:
description: The specified resource was not found
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ErrorV2'
example:
- code: record_not_found
message: not found
securitySchemes:
Bearer:
type: apiKey
name: Authorization
in: header
description: >-
The authentication token generated from providing API Keys to Sezzle
Gateway
````