# Show billing manual balance changes ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/billing/manual_balance_changes: get: summary: 'Show billing manual balance changes ' deprecated: false description: Show history of manual changes to customer balance tags: - API Reference/Management API/Core/Billing/Customer Balance parameters: - name: per_page in: query description: >- Number of results to be returned per request. See: [API Pagination](doc-341638) example: 10 schema: type: integer default: '10' - name: page_no in: query description: 'Number of results page. See: [API Pagination](doc-341638)' example: 1 schema: type: integer minimum: 1 default: '1' - name: Content-Type in: header description: '[Details](doc-341635)' required: true example: application/json schema: type: string default: application/json const: application/json - name: X-User-Agent in: header description: Arbitrary identifier of your client. [Details](doc-341635) required: true example: '{{X_USER_AGENT}}' schema: type: string default: '{{X_USER_AGENT}}' - name: X-Product-Name in: header description: API Product for API context. [Details](doc-341635) required: true example: '{{PRODUCT_NAME}}' schema: type: string default: '{{PRODUCT_NAME}}' - name: X-Customer in: header description: Customer for API context. [Details](doc-342139) required: false example: '{{CUSTOMER_ID}}' schema: type: string default: '{{CUSTOMER_ID}}' - name: Authorization in: header description: '[Member](doc-342129) or [User](doc-342130) Authorization.' required: false example: Bearer {{_OAUTH_TOKEN}} schema: type: string default: Bearer {{_OAUTH_TOKEN}} responses: '200': description: '' content: application/json: schema: type: object properties: manual_balance_changes: type: array items: properties: id: type: integer x-apidog-mock: '{{$number.int}}' minimum: 1 date: type: string x-apidog-mock: '{{$date.isoTimestamp}}' value: type: string x-apidog-mock: '{{$string.numeric}}' type: type: string enum: - refill - correction x-apidog-enum: - value: refill name: '' description: '' - value: correction name: '' description: '' bl_user_id: type: string x-apidog-mock: '{{$string.uuid}}' x-apidog-orders: - id - date - value - type - bl_user_id required: - id - date - value - type - bl_user_id $ref: '#/components/schemas/ManualBalanceChange' pagination_info: $ref: '#/components/schemas/PaginationInfo' required: - manual_balance_changes - pagination_info x-apidog-orders: - manual_balance_changes - pagination_info x-apidog-ignore-properties: [] example: manual_balance_changes: - id: 5542816891805633 date: '2025-04-01T11:29:17.304Z' value: '-9.9' type: correction bl_user_id: 075fdddd-dceb-454f-a202-189aaab62ee8 - id: 2558616565395370 date: '2025-04-01T11:29:17.305Z' value: '100.0' type: refill bl_user_id: 361da9bb-07e3-436f-b5ed-484eda087e6b - id: 1256274720473543 date: '2025-04-01T11:29:17.309Z' value: '-30.0' type: correction bl_user_id: 98f2ba6d-45de-4b49-9135-693809ba2683 pagination_info: total_count: 2050 headers: {} x-apidog-name: Success '422': description: '' content: application/json: schema: type: object properties: error: type: string details: type: object properties: period: type: array items: type: object properties: error: type: string message: type: string options: type: object properties: {} x-apidog-orders: [] x-apidog-ignore-properties: [] x-apidog-orders: - error - message - options x-apidog-ignore-properties: [] offset: type: array items: type: object properties: error: type: string message: type: string options: type: object properties: {} x-apidog-orders: [] x-apidog-ignore-properties: [] x-apidog-orders: - error - message - options x-apidog-ignore-properties: [] x-apidog-orders: - period - offset x-apidog-ignore-properties: [] required: - error - details x-apidog-orders: - error - details x-apidog-ignore-properties: [] example: error: Invalid parameters details: period: - error: inclusion message: is not included in the list options: in: - month - year headers: {} x-apidog-name: Parameter Error security: [] x-apidog-folder: API Reference/Management API/Core/Billing/Customer Balance x-apidog-status: released x-run-in-apidog: https://app.eu.apidog.com/web/project/346351/apis/api-3762155-run components: schemas: PaginationInfo: type: object properties: count: type: integer description: Actual number of results returned in request readOnly: true examples: - 1000 total_count: type: integer description: Number of all available results minimum: 1 examples: - 2050 per_page: type: integer description: Number of results returned per request readOnly: true examples: - 1000 total_pages: type: integer description: Number of all available pages readOnly: true examples: - 3 current_page: type: integer readOnly: true examples: - 1 next_page: type: integer description: Next available page (null when it's a last page) readOnly: true examples: - 2 nullable: true prev_page: type: integer description: Next available page (null when it's a first page) readOnly: true examples: - null nullable: true is_first_page: type: boolean readOnly: true examples: - true is_last_page: type: boolean readOnly: true examples: - false is_out_of_range: type: boolean description: Is given `per_page` param out of range? readOnly: true examples: - false offset: type: integer readOnly: true examples: - 0 required: - count - total_count - per_page - total_pages - current_page - next_page - prev_page - is_first_page - is_last_page - is_out_of_range - offset x-apidog-orders: - count - total_count - per_page - total_pages - current_page - next_page - prev_page - is_first_page - is_last_page - is_out_of_range - offset readOnly: true x-apidog-ignore-properties: [] nullable: true x-apidog-folder: '' ManualBalanceChange: type: object properties: id: type: integer x-apidog-mock: '{{$number.int}}' minimum: 1 date: type: string x-apidog-mock: '{{$date.isoTimestamp}}' value: type: string x-apidog-mock: '{{$string.numeric}}' type: type: string enum: - refill - correction x-apidog-enum: - value: refill name: '' description: '' - value: correction name: '' description: '' description: Type of change - refill (positive), correction (negative) bl_user_id: type: string x-apidog-mock: '{{$string.uuid}}' description: User id x-apidog-orders: - id - date - value - type - bl_user_id required: - id - date - value - type - bl_user_id x-apidog-ignore-properties: [] x-apidog-folder: '' securitySchemes: {} servers: - url: https://api.mpc.dev.placewise.com description: Staging security: [] ```