---
title: "GET /charges"
method: GET
path: "/charges"
tags: ["Charges"]
---

# GET /charges

`GET /charges`

Retrieve all charges

## Query parameters

- `created_at_min` string, date-time
- `created_at_max` string, date-time
- `test_mode` boolean
- `offset` integer
- `limit` integer
- `dir` 'next' | 'prev'

## Response `200`

Successful operation. Response will return an array of 0 or more charges

- object
  - `data` ChargeService[]
    - `id` integer — The SamCart ID for the charge
    - `customer_id` integer — The SamCart ID for the customer that created the charge
    - `affiliate_id` integer, nullable — The SamCart ID of the affiliate credited for the order
    - `order_id` integer — The SamCart ID for the order. For subscriptions, this will be the order ID of the original purchase
    - `subscription_rebill_id` integer, nullable — The SamCart ID for the subscription rebill. If the charge is for a non-subscription product, this will be null.
    - `test_mode` boolean — Indicates whether the transaction was done while the product was in test mode
    - `processor_name` 'Stripe' | 'Braintree' | 'Authorize.net' | 'PayPal' — The name of the processor for the order
    - `processor_transaction_id` string — The processor ID generated for the charge
    - `currency` string — The 3 letter identifier for the currency for the charge
    - `card_used` number, nullable — The last 4 digits of the card that was used. PayPal charges will have a null value.
    - `charge_refund_status` 'refunded' | 'partially_refunded', nullable — Indicates whether a refund and the type of refund. If no refund was created the value will be null.
    - `order_date` string, date-time — The UTC date and time for when the order was created
    - `created_at` string, date-time — The UTC date and time that the charge was created
    - `total` integer — The total (in cents) for the charge including taxes and shipping fees
  - `pagination` Pagination — Optional information for paginating large data sets.
    - `next` string, uri, nullable — A URL to the next page of data to be retrieve. If current page is the last page this value will be null.
    - `prev` string, uri, nullable — A URL to the previous page of data to be retrieve. If current page is the first page this value will be null.

---

[API](https://skmtc.dev/samcart/apis/samcart-public-api.md) · [All operations](https://skmtc.dev/samcart/apis/samcart-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/samcart/samcart-public-api/revisions/80296f7a00d0/schema)