List Expenses

GET /api/expenses

Retrieves a paginated list of expenses for the authenticated user with support for filtering by profile, date, category, and more.

Authentication

This endpoint requires authentication. Include your access token in the request cookies.

Query Parameters

string

Filter expenses by specific profile ID (RFC emisor)

number

Filter by month (1-12)

number

Filter by year (e.g., 2024)

string

Filter by fiscal regime

string

Filter by payment type. Options: PUE, PPD, COMPLEMENTO_PAGO

string

Filter by expense category

number

default:"1"

Page number for pagination

number

default:"20"

Number of items per page

string

Search term to filter expenses by concept, RFC, or name

Response

Expense[]

Array of expense objects

Show Expense Object

string

required

Unique identifier for the expense

string

required

Profile ID associated with this expense

string

required

Origin type. Options: XML, MANUAL

string

required

Date of the expense (ISO 8601 format)

number

required

Month of the expense (1-12)

number

required

Year of the expense

number

required

Total amount including taxes

number

required

Subtotal before taxes

number

required

IVA percentage

number

IVA amount (transferred tax)

number

IVA retention amount

number

ISR retention amount

boolean

Payment status

string

Payment date (ISO 8601 format)

string

Description/concept of the expense

string

Category of the expense

string

Fiscal UUID from SAT (for XML expenses)

string

Payment type: PUE, PPD, COMPLEMENTO_PAGO

string

RFC of the issuer

string

Name of the issuer

string

RFC of the receiver

string

Name of the receiver

string

required

Creation timestamp (ISO 8601)

string

required

Last update timestamp (ISO 8601)

object

required

Pagination information

Show Pagination Object

number

required

Total number of expenses matching the filters

number

required

Current page number

number

required

Items per page

number

required

Total number of pages

Example Request

curl -X GET "https://api.contafy.com/api/expenses?page=1&limit=20&mes=3&año=2024" \
  -H "Cookie: access_token=your_access_token"

Example Response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "profile_id": "profile-123",
      "tipo_origen": "XML",
      "fecha": "2024-03-15T10:30:00Z",
      "mes": 3,
      "año": 2024,
      "total": 11600,
      "subtotal": 10000,
      "iva": 16,
      "iva_amount": 1600,
      "is_paid": true,
      "payment_date": "2024-03-15T10:30:00Z",
      "concepto": "Servicios de consultoría",
      "categoria": "Servicios profesionales",
      "uuid": "12345678-1234-1234-1234-123456789012",
      "tipo": "PUE",
      "rfc_emisor": "XAXX010101000",
      "nombre_emisor": "Proveedor Ejemplo SA de CV",
      "rfc_receptor": "CACX7605101P8",
      "nombre_receptor": "Mi Empresa",
      "created_at": "2024-03-15T10:35:00Z",
      "updated_at": "2024-03-15T10:35:00Z"
    }
  ],
  "pagination": {
    "total": 150,
    "page": 1,
    "limit": 20,
    "totalPages": 8
  }
}

Error Responses

error

Authentication required or token expired

{
  "error": "Unauthorized",
  "message": "Authentication required"
}

error

Invalid query parameters

{
  "error": "Bad Request",
  "message": "Invalid month value. Must be between 1 and 12"
}

error

Server error occurred

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}

Authentication

Profiles

Invoices

Expenses

Subscription

SAT Search

GET /api/expenses

Authentication

Query Parameters

Response

Example Request

Example Response

Error Responses

​GET /api/expenses

​Authentication

​Query Parameters

​Response

​Example Request

​Example Response

​Error Responses

GET /api/expenses

Authentication

Query Parameters

Response

Example Request

Example Response

Error Responses