Expenses

Create an expense

Creates an itemized organization expense and starts its approval flow when applicable.

post/v1/expenses

Request

Base URL
https://api.paymongo.com
URL
https://api.paymongo.com/v1/expenses
Auth
HTTP basic

Request body

amountinteger required

categorystring

commentstring

createdstring required

currencystring required

destination_account_namestring

destination_account_numberstring

destination_bicstring

employee_emailstring

merchantstring

metadataobject

ocr_extractedobject

receipt_file_idstring

supporting_document_idsstring[]

tagstring

tax_amountinteger

Example request

{
  "amount": 125000,
  "category": "meals",
  "comment": "Client meeting lunch",
  "created": "2026-07-15 09:30:00+08:00",
  "currency": "PHP",
  "destination_account_name": "Sample Employee",
  "destination_account_number": "0917-123-4567",
  "destination_bic": "GXCHPHM2XXX",
  "employee_email": "employee@example.com",
  "items": [
    {
      "amount": 125000,
      "category": "meals",
      "currency": "PHP",
      "name": "Team lunch",
      "quantity": 1,
      "tax_amount": 13393
    }
  ],
  "merchant": "Sample Restaurant",
  "receipt_file_id": "file_abc123",
  "supporting_document_ids": [
    "doc_abc123"
  ],
  "tag": "client_meeting",
  "tax_amount": 13393
}

Response

Expense created

approved_countinteger

approved_total_amountinteger

has_moreboolean

pending_countinteger

rejected_countinteger

total_amountinteger

Example response

{
  "approved_count": 1,
  "approved_total_amount": 125000,
  "data": {
    "amount": 125000,
    "category": "meals",
    "comment": "Client meeting lunch",
    "created": "2026-07-15 09:30:00+08:00",
    "created_at": "2026-07-15 01:30:00+00:00",
    "currency": "PHP",
    "destination_account_name": "Sample Employee",
    "destination_account_number": "0917-123-4567",
    "destination_bic": "GXCHPHM2XXX",
    "employee_email": "employee@example.com",
    "id": "exp_abc123",
    "is_wallet_destination": true,
    "items": [
      {
        "amount": 125000,
        "category": "meals",
        "currency": "PHP",
        "id": "exi_abc123",
        "line_no": 1,
        "name": "Team lunch",
        "quantity": 1,
        "tax_amount": 13393
      }
    ],
    "merchant": "Sample Restaurant",
    "org_id": "org_abc123",
    "receipt_file_id": "file_abc123",
    "status": "open",
    "supporting_document_ids": [
      "doc_abc123"
    ],
    "tag": "client_meeting",
    "tax_amount": 13393,
    "type": "expense",
    "updated_at": "2026-07-15 01:35:00+00:00"
  },
  "has_more": true,
  "pending_count": 1,
  "total_amount": 250000
}

Changes

No recorded changes to this operation across all 1 revision of this API.