> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Transactions > List individual credit-usage transactions (most recent first). The per-operation **credit ledger**: every credit debit, what consumed it (operation/extractor/resource), and when — the transaction-level itemization beyond the aggregated `/usage/breakdown` totals. **Query Parameters:** - `limit`: page size (1-200, default 50) - `offset`: records to skip - `billing_month`: optional YYYY-MM filter **Requirements:** Read permission. **Example:** ```python response = await client.get( "/v1/organizations/billing/transactions", params={"limit": 50, "billing_month": "2026-06"}, ) ``` ## OpenAPI ````yaml get /v1/organizations/billing/transactions openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: - BearerAuth: [] paths: /v1/organizations/billing/transactions: get: tags: - Organization Billing summary: List Transactions description: >- List individual credit-usage transactions (most recent first). The per-operation **credit ledger**: every credit debit, what consumed it (operation/extractor/resource), and when — the transaction-level itemization beyond the aggregated `/usage/breakdown` totals. **Query Parameters:** - `limit`: page size (1-200, default 50) - `offset`: records to skip - `billing_month`: optional YYYY-MM filter **Requirements:** Read permission. **Example:** ```python response = await client.get( "/v1/organizations/billing/transactions", params={"limit": 50, "billing_month": "2026-06"}, ) ``` operationId: list_transactions_v1_organizations_billing_transactions_get parameters: - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 description: Page size (max 200) examples: - 50 default: 50 title: Limit description: Page size (max 200) - name: offset in: query required: false schema: type: integer minimum: 0 description: Records to skip (pagination) default: 0 title: Offset description: Records to skip (pagination) - name: billing_month in: query required: false schema: anyOf: - type: string - type: 'null' description: Optional YYYY-MM filter (defaults to all months) examples: - 2026-06 title: Billing Month description: Optional YYYY-MM filter (defaults to all months) responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TransactionsListResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: TransactionsListResponse: properties: transactions: items: $ref: '#/components/schemas/TransactionInfo' type: array title: Transactions description: Credit-usage transactions, newest first total: type: integer title: Total description: Total matching transactions limit: type: integer title: Limit description: Page size offset: type: integer title: Offset description: Records skipped has_more: type: boolean title: Has More description: Whether more transactions exist beyond this page type: object required: - total - limit - offset - has_more title: TransactionsListResponse description: Paginated list of credit-usage transactions (most recent first). ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TransactionInfo: properties: record_id: type: string title: Record Id description: Unique usage-record ID occurred_at: type: string format: date-time title: Occurred At description: When the credits were consumed billing_month: type: string title: Billing Month description: Billing month (YYYY-MM) credits_consumed: type: integer title: Credits Consumed description: Credits consumed by this operation cost_usd: type: number title: Cost Usd description: Approx USD cost (credits * $0.001) operation_type: type: string title: Operation Type description: Operation that consumed credits (extractor, upload, batch, search) extractor_name: anyOf: - type: string - type: 'null' title: Extractor Name description: Extractor name, if operation was an extraction resource_id: anyOf: - type: string - type: 'null' title: Resource Id description: ID of the resource processed (collection/object/batch) resource_type: anyOf: - type: string - type: 'null' title: Resource Type description: Type of resource processed namespace_id: anyOf: - type: string - type: 'null' title: Namespace Id description: >- Namespace this charge is attributed to, so the per-row ledger is traceable per namespace for chargeback. None for namespace-less / pre-attribution records. app_id: anyOf: - type: string - type: 'null' title: App Id description: Canvas App ID, if attributed metadata: additionalProperties: true type: object title: Metadata description: Operation context (tokens, pages, minutes, etc.) type: object required: - record_id - occurred_at - billing_month - credits_consumed - cost_usd - operation_type title: TransactionInfo description: A single credit-usage transaction (per-operation ledger entry). ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer description: >- Mixpeek API key, sent as `Authorization: Bearer mxp_sk_...`. Create one in Studio under Settings → API Keys, or with an admin key via `POST /v1/organizations/users/{user_email}/api-keys`. A missing header returns 403; an invalid or revoked key returns 401. ````