# 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."}}}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.moregoodreviews.com/platform/api-reference/charges.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.