---
title: "List Payments"
method: GET
path: "/payments"
tags: ["payments", "Account Line Items"]
---

# List Payments

`GET /payments`

List Payments

## Query parameters

- `cursor` string
- `per_page` integer

## Response `200`

A list of Payments objects.

- AccountLineItemEntity[]
  - `id` integer — Line item Id
  - `amount` string, decimal — Line item amount
  - `balance` string, decimal — Line item balance
  - `created_at` string, date-time — Line item created at
  - `currency` string — Line item currency
  - `download_uri` string — Line item download uri
  - `invoice_line_items` InvoiceLineItemEntity[] — Associated invoice line items
    - `id` integer — Invoice Line item Id
    - `amount` string, decimal — Invoice line item amount
    - `created_at` string, date-time — Invoice line item created at date/time
    - `description` string — Invoice line item description
    - `type` 'invoice' | 'invoice_adjustment' | 'usage_overage' | 'user_overage' | 'addon_subscription' | 'misc_fee' | 'usage_overage_adjustment' | 'user_overage_adjustment' | 'addon_subscription_adjustment' | 'misc_fee_adjustment' | 'credit_expiration' | 'user_overage_prepay' | 'user_overage_prepay_adjustment' | 'credit_expiration_adjustment' | 'outbound_connection_overage' | 'outbound_connection_overage_adjustment' | 'files_agent_overage' | 'files_agent_overage_adjustment' | 'automation_and_sync_flows_overage' | 'automation_and_sync_flows_overage_adjustment' | 'transformation_and_ai_credits_usage_overage' | 'transformation_and_ai_credits_usage_overage_adjustment' | 'api_usage_overage' | 'api_usage_overage_adjustment' — Invoice line item type
    - `service_end_at` string, date-time — Invoice line item service end date/time
    - `service_start_at` string, date-time — Invoice line item service start date/time
    - `plan` string — Plan name
    - `site` string — Site name
    - `prepaid_bytes` integer — Prepaid bytes purchased for this invoice line item
    - `prepaid_bytes_expire_at` string, date-time — When the prepaid bytes expire
    - `prepaid_bytes_used` integer — Total prepaid bytes used for this invoice line item
    - `prepaid_bytes_available` integer — Available prepaid bytes for this invoice line item
  - `method` string — Line item payment method
  - `payment_line_items` PaymentLineItemEntity[] — Associated payment line items
    - `amount` string, decimal — Payment line item amount
    - `created_at` string, date-time — Payment line item created at date/time
    - `invoice_id` integer — Invoice ID
    - `payment_id` integer — Payment ID
  - `payment_reversed_at` string, date-time — Date/time payment was reversed if applicable
  - `payment_type` string — Type of payment if applicable
  - `site_name` string — Site name this line item is for
  - `type` string — Type of line item, either payment or invoice

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

[API](https://skmtc.net/files/apis/files-com-api.md) · [All operations](https://skmtc.net/files/apis/files-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/files/files-com-api/versions/c80c746637fd/schema)