> For the complete documentation index, see [llms.txt](https://docs.moregoodreviews.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moregoodreviews.com/platform/api-reference/charges.md).

# Charges

## List Charges

> Paginated revenue charge rows for the authenticated project with optional calendar bounds on charged-at times.

```json
{"openapi":"3.0.3","info":{"title":"MGR Project API","version":"1.0.0"},"tags":[{"name":"Charges"}],"servers":[{"url":"https://api.moregoodreviews.com/project"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ApiKey"}}},"paths":{"/charges":{"get":{"tags":["Charges"],"summary":"List Charges","operationId":"listCharges","description":"Paginated revenue charge rows for the authenticated project with optional calendar bounds on charged-at times.","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"type":"string","format":"date","nullable":true,"description":"Inclusive lower calendar date for filtering charges by charged-at time (YYYY-MM-DD)."},"description":"Inclusive lower calendar date for filtering charges by charged-at time (YYYY-MM-DD)."},{"name":"date_to","in":"query","required":false,"schema":{"type":"string","format":"date","nullable":true,"description":"Inclusive upper calendar date for filtering charges by charged-at time (YYYY-MM-DD). Must be on or after date_from when both are provided."},"description":"Inclusive upper calendar date for filtering charges by charged-at time (YYYY-MM-DD)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","nullable":true,"description":"Maximum number of records to return per page."},"description":"Maximum number of records to return per page."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Object containing response data for this resource.","properties":{"success":{"type":"boolean","description":"Indicates whether the request completed successfully."},"code":{"type":"integer","description":"Short code or application-level status code for this resource."},"data":{"type":"array","description":"Charge rows ordered by most recent charged-at time.","items":{"type":"object","description":"Stored charge belonging to this project.","properties":{"amount":{"type":"integer","description":"Charge amount in the smallest currency unit."},"charged_at":{"type":"string","description":"RFC3339 timestamp when the charge occurred.","nullable":true},"currency":{"type":"string","description":"Three-letter ISO currency code.","nullable":true},"customer_id":{"type":"integer","description":"Unique numeric identifier for the customer who owns this charge."},"id":{"type":"integer","description":"Unique numeric identifier for this charge row."},"project_id":{"type":"integer","description":"Unique numeric identifier for the project this charge belongs to.","nullable":true}}}},"pagination":{"type":"object","description":"Pagination metadata for list responses.","properties":{"current_page":{"type":"integer","description":"Current page number in the paginated result set."},"from":{"type":"integer","description":"Index of the first item returned on the current page."},"last_page":{"type":"integer","description":"Last available page number in the paginated result set."},"path":{"type":"string","description":"Base API path used for the paginated result set."},"per_page":{"type":"integer","description":"Number of items returned per page."},"to":{"type":"integer","description":"Index of the last item returned on the current page."},"total":{"type":"integer","description":"Total number of matching items."}}}}}}}}}}}}}
```

## Create Charge

> Record a customer revenue event from an external billing system.

```json
{"openapi":"3.0.3","info":{"title":"MGR Project API","version":"1.0.0"},"tags":[{"name":"Charges"}],"servers":[{"url":"https://api.moregoodreviews.com/project"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ApiKey"}},"schemas":{"ProjectApiDateTimeInput":{"description":"Optional instant for request bodies: Unix timestamp as integer (seconds), or a date/time string of at most\n50 characters that PHP Carbon can parse. For strings, ISO-8601 / RFC 3339 (for example 2026-04-28T15:30:00Z) is the\nrecommended format in examples and client integrations. Invalid values fail validation. When the field is omitted\nor null, the API uses the current server time where that behavior is documented on the operation.","nullable":true,"oneOf":[{"type":"integer","description":"Unix timestamp in seconds since the Unix epoch."},{"type":"string","maxLength":50,"description":"Date/time string parseable by Carbon; prefer ISO-8601 / RFC 3339; maximum 50 characters."}]}}},"paths":{"/charges":{"post":{"tags":["Charges"],"summary":"Create Charge","operationId":"createCharge","description":"Record a customer revenue event from an external billing system.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Object containing response data for this resource.","properties":{"success":{"type":"boolean","description":"Indicates whether the request completed successfully."},"code":{"type":"integer","description":"Short code or application-level status code for this resource."},"data":{"type":"object","description":"Response payload for the request.","properties":{"email":{"type":"string","description":"Email address for the person or customer."},"phone":{"type":"string","description":"Phone number for the person or customer."},"amount":{"type":"integer","description":"Charge amount in the smallest currency unit."},"currency":{"type":"string","description":"Three-letter ISO currency code."},"charged_at":{"type":"string","description":"Timestamp or date when the charge occurred."}}}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Object containing response data for this resource.","properties":{"amount":{"type":"integer","description":"Charge amount in the smallest currency unit."},"email":{"type":"string","description":"Email address for the person or customer."},"phone":{"type":"string","description":"Phone number for the person or customer."},"currency":{"type":"string","description":"Three-letter ISO currency code."},"location_slug":{"type":"string","description":"Slug of the location associated with the record."},"charged_at":{"$ref":"#/components/schemas/ProjectApiDateTimeInput"}},"required":["amount"]}}}}}}}}
```

## Delete Charge

> Permanently remove a mistaken charge row scoped to this project’s customers.

```json
{"openapi":"3.0.3","info":{"title":"MGR Project API","version":"1.0.0"},"tags":[{"name":"Charges"}],"servers":[{"url":"https://api.moregoodreviews.com/project"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ApiKey"}}},"paths":{"/charges/{id}":{"delete":{"tags":["Charges"],"summary":"Delete Charge","operationId":"deleteCharge","description":"Permanently remove a mistaken charge row scoped to this project’s customers.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Object confirming the charge row was deleted.","properties":{"success":{"type":"boolean","description":"Indicates whether the request completed successfully."},"code":{"type":"integer","description":"Application-level status code returned by this API."}}}}}}}}}}}
```