Account Status Report

Get an account status report with commission and transaction details.

Endpoint: GET /account-status

Parameters:

  • year (required): Report year (e.g., 2025)
  • month (required): Report month (1-12)

Example request:

curl -X GET "https://services.digitalfemsa.io/reports/v1/account-status?year=2025&month=9" \
  -H "Authorization: Bearer key_XXXXXXXXXXXXXX"

Expected response:

{
    "has_more": false,
    "total": 10,
    "object": "list",
    "data": [
        {
            "amount": 2,
            "charge_id": "68b8808117866d000164de56",
            "commission": 0,
            "commission_details": [
                {
                    "amount": 12,
                    "concept": "spei_payment_autofund_capture",
                    "description": "SPEI Payment Autofund Capture Fee"
                },
                {
                    "amount": 1.92,
                    "concept": "spei_payment_autofund_capture_tax",
                    "description": "SPEI Payment Autofund Capture Fee Tax"
                },
                {
                    "amount": -12,
                    "concept": "fee_discount",
                    "description": "Fee Discount"
                },
                {
                    "amount": -1.92,
                    "concept": "fee_discount_tax",
                    "description": "Fee Discount Tax"
                }
            ],
            "company_id": "5f90a9802238c00001b064dc",
            "created_at": 1756921987719,
            "deposit_id": "",
            "invoice_date": "2025-09",
            "net": 2,
            "payment_type": "SpeiPayment",
            "status": "retained",
            "transaction_id": "68b88083133e91000118240e",
            "type_transaction": "autofund_capture"
        }
    ]
}

Response Codes

  • 200 OK: Successful request
  • 401 Unauthorized: Invalid or missing authentication token
  • 400 Bad Request: Invalid parameters
  • 404 Not Found: Resource not found
  • 500 Internal Server Error: Server error

Considerations

  • All amounts are in the specified currency (generally MXN)
  • Dates are in timestamp format (milliseconds since epoch)
  • Reports may be paginated, check the has_more field to determine if there are more results
  • Sensitive data such as card numbers are masked for security