# Get All Charges

Retrieve all charges with pagination

Endpoint: GET /v1/charges
Version: v1
Security: account-secret

## Query parameters:

  - `page` (integer)
    Page number (0-based)

  - `limit` (integer)
    Number of charges per page
    Example: 20

  - `merchant_id` (string)
    Optional merchant ID to filter charges
    Example: "merchant_01j3sc1n1keghbg5q97gr1s08m"

  - `payment_type` (string)
    Optional payment type to filter charges
    Enum: "MANUAL", "INVOICE", "TERMINAL", "SCAN_TO_PAY"

  - `status` (string)
    Optional status to filter charges
    Enum: "AUTHORIZED", "SETTLED"

  - `charge_id` (string)
    Optional charge ID to filter charges
    Example: "ch_01j8emz8chfxbb2bqmtref8ch7"

## Response 200 fields (application/json):

  - `charges` (array, required)
    List of charges

  - `charges.id` (string)
    Unique identifier for the charge
    Example: "ch_01j8emz8chfxbb2bqmtref8ch7"

  - `charges.merchant` (object, required)

  - `charges.merchant.id` (string, required)
    Unique identifier for the merchant
    Example: "merchant_02c7h71rf3eg396idngupsr66t"

  - `charges.payment_type` (string, required)
    Type of payment for the charge
    Example: "MANUAL"

  - `charges.status` (string, required)
    status of the charge
    Enum: "AUTHORIZED", "SETTLED"

  - `charges.requested_amount` (integer, required)
    Requested amount for the charge
    Example: 100

  - `charges.amount_authorized` (integer, required)
    Amount authorized for the charge
    Example: 100

  - `charges.amount_captured` (integer, required)
    Amount captured for the charge
    Example: 100

  - `charges.tip` (integer, required)
    Tip amount for the charge
    Example: 1

  - `charges.tax` (integer, required)
    Tax amount for the charge
    Example: 10

  - `charges.card_last_4` (string)
    Last 4 digits of the card used for the charge
    Example: "1234"

  - `charges.card_brand` (string)
    Brand of the card used for the charge
    Example: "VISA"

  - `charges.created_at` (integer, required)
    Timestamp when the charge was created
    Example: 1727875117482

  - `charges.card_entry_method` (string, required)
    Method used for card entry
    Enum: "SWIPE", "CHIP", "MANUAL"

  - `charges.billing_address` (object)
    Billing address details

  - `charges.billing_address.company` (string)
    Company name associated with the address
    Example: "Acme Corp"

  - `charges.billing_address.phone` (string, required)
    Phone number associated with the address
    Example: "+1234567890"

  - `charges.billing_address.email` (string, required)
    Email address associated with the address
    Example: "example@domain.com"

  - `charges.billing_address.first_name` (string)
    First name of the person associated with the address
    Example: "John"

  - `charges.billing_address.last_name` (string)
    Last name of the person associated with the address
    Example: "Doe"

  - `charges.billing_address.address_line_1` (string)
    First line of the address
    Example: "123 Main St"

  - `charges.billing_address.address_line_2` (string)
    Second line of the address
    Example: "Apt 4B"

  - `charges.billing_address.city` (string)
    City of the address
    Example: "New York"

  - `charges.billing_address.state` (string)
    State of the address
    Example: "NY"

  - `charges.billing_address.postal_code` (string)
    Postal code of the address
    Example: "10001"

  - `charges.billing_address.country` (string)
    Country of the address
    Example: "USA"

  - `charges.billing_address.fax` (string)
    Fax number associated with the address
    Example: "+1234567890"

  - `charges.card_expiration_date` (string)
    Expiration date of the card
    Example: "01/27"

  - `charges.card_type` (string)
    Type of the card
    Example: "debit"

  - `charges.failure_reason` (string)
    Reason for the charge failure
    Example: "Card declined"

  - `page` (integer, required)
    Current page number (0-based)

  - `limit` (integer, required)
    Number of charges per page
    Example: 20

  - `total` (integer, required)
    Total number of charges
    Example: 150