Skip to content

getTaxInvoiceList

List your platform service fee invoices (monthly billing records).

Request

POST /api/v2/getTaxInvoiceList

Headers

Header Required Description
token Yes Your API Key
Content-Type Yes application/json

Body Parameters

Field Type Required Default Description
page integer No 1 Page number for pagination
limit integer No 10 Results per page
search string No — Search filter
date string No — Filter by month (YYYY-MM)

Response

Success

{
  "data": [
    {
      "sf_id": "178",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "company": "Acme GmbH",
      "name": "Max Mustermann",
      "street": "Musterstraße",
      "house_no": "1",
      "city": "Berlin",
      "country": "Germany",
      "zipcode": "10115",
      "invoice_id": "202604-sf-oS5TYzrGXF",
      "invoice_date": "2026-05-01",
      "service_month": "April 2026",
      "total_secpaid_fee": 10.38,
      "total_psp_fee": 245.15,
      "vat": 0,
      "created_at": "2026-05-01 03:01:05"
    }
  ],
  "totalRecords": 18,
  "ResponseCode": 1,
  "ResponseMsg": "List retrived successfully",
  "Result": "True",
  "ServerTime": "CEST"
}

Response Fields (per item)

Field Type Description
sf_id string Internal record ID
invoice_id string Invoice reference (format: YYYYMM-sf-XXXXXXXXXX)
invoice_date string Date the invoice was issued
service_month string Human-readable billing period (e.g., "April 2026")
total_secpaid_fee number Total platform fees for the month
total_psp_fee number Total payment provider fees for the month
vat number VAT amount (0 for reverse-charge)
company string Your company name
name string Account holder name
street, house_no, city, country, zipcode string Billing address
created_at string When the record was generated

totalRecords (top-level) gives the total count for pagination.

Examples

curl -X POST https://app.secpaid.com/api/v2/getTaxInvoiceList \
  -H "Content-Type: application/json" \
  -H "token: YOUR_API_KEY" \
  -d '{"page": 1, "limit": 12}'

const response = await fetch("https://app.secpaid.com/api/v2/getTaxInvoiceList", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "token": "YOUR_API_KEY"
  },
  body: JSON.stringify({ page: 1, limit: 12 })
});

$response = Http::withHeaders([
    'token' => 'YOUR_API_KEY',
])->post('https://app.secpaid.com/api/v2/getTaxInvoiceList', [
    'page' => 1,
    'limit' => 12,
]);

Notes

  • Invoices are generated monthly (on the 1st) for the prior month's service fees
  • This endpoint includes totalRecords for pagination
  • total_secpaid_fee is the platform fee; total_psp_fee is the PSP (payment processing) fee
  • Billing address is pulled from your account settings