Developer API

Build with PayRequest

Automate your billing workflows with our powerful REST API. Create invoices, track payments, and manage customers programmatically. Perfect for SaaS platforms, AI agents, and custom integrations.

Base URL:https://payrequest.app/api/v1
Get API Access
Read Documentation
99.9%
API Uptime
<100ms
Avg Response
60/min
Rate Limit
terminal
$curl request
curl -X POST \
  https://payrequest.app/api/v1/invoices \
  -H "Authorization: Bearer $TOKEN"
<response200 OK
{
  "id": 1542,
  "status": "pending",
  "payment_url": "https://pay.payrequest.io/..."
}
REST API
JSON responses
OAuth2
Bearer tokens
Capabilities

What you can build

Our API gives you full control over your billing operations. From simple invoice automation to complex AI-powered billing agents.

01

Automated Invoicing

Create, send, and manage invoices programmatically. Perfect for recurring billing, usage-based pricing, and bulk operations.

Create invoicesAdd line itemsAuto-send emailsTrack status
02

Real-time Data

Access billing statistics, payment status, and customer data instantly. Build dashboards, reports, and monitoring tools.

Invoice statsPayment trackingOverdue alertsRevenue metrics
03

Payment Reminders

Automate follow-ups for unpaid invoices. Reduce manual work and improve collection rates with smart reminder workflows.

Auto follow-upsCustom schedulesEmail & SMSTrack delivery
04

AI-Ready

Built for modern AI workflows. Native MCP server support lets AI agents manage billing autonomously with full context.

MCP compatiblebilling.agent scopeNatural languageContext-aware
Learn more about MCP
AI Integration

Connect AI assistants with MCP

The Model Context Protocol lets AI assistants like Claude, ChatGPT, and Gemini interact with your billing data using natural language. Manage invoices, track payments, and send reminders — all through conversation.

Works with Claude Desktop & Claude Code
ChatGPT custom actions support
Gemini function calling
Cursor IDE integration
4 billing tools included
get-invoice-statslist-invoicesget-overdue-invoicessend-invoice-reminder
Explore MCP Integration
AI Billing Assistant
Connected via MCP
Live

Show me all overdue invoices

Using get-overdue-invoicesMCP

I found 3 overdue invoices totaling €847.50...

Works with:
C
G
G
C
Code Examples

Simple, powerful API

RESTful endpoints with clear responses. Get started in minutes with your favorite language.

Core Endpoints

GET/invoices
GET/invoices/{id}
POST/invoices
GET/invoices/stats
GET/invoices/overdue
POST/invoices/{id}/reminder
request.sh
curl -X POST https://payrequest.app/api/v1/invoices \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": 123,
    "date": "2026-01-29",
    "due_date": "2026-02-28",
    "items": [{
      "description": "Monthly subscription",
      "quantity": 1,
      "unit_price": 29.00
    }]
  }'
Response
{
  "data": {
    "id": 1542,
    "invoice_number": "INV-2026-0042",
    "status": "pending",
    "total": 29.00,
    "currency": "EUR",
    "payment_url": "https://pay.payrequest.io/i/abc123"
  }
}
OAuth2 Authentication

Secure by design

Industry-standard OAuth2 with granular scopes. Control exactly what each integration can access.

Token Expiration

Personal Tokens6 months
Access Tokens15 days
Refresh Tokens30 days
Bearer token authentication
Granular permission scopes
Rate limit headers included
Automatic token refresh

Available Scopes

Permission scopes for API access

billing.readView invoices, subscriptions, transactions
billing.writeCreate and modify invoices
billing.agentFull AI billing access
customers.readView customer data
customers.writeModify customer records
products.readView product catalog
products.writeManage products
AI Agent Ready
billing.agent scope enables MCP server integration
Use Cases

Built for real workflows

See how developers use our API to automate billing and build powerful integrations.

SaaS Billing

Automate subscription invoicing, usage-based billing, and dunning flows. Sync with your existing systems.

Invoice Automation

Generate invoices from CRM deals, project completions, or custom triggers. Eliminate manual data entry.

AI Billing Agents

Let AI handle invoice creation, payment follow-ups, and customer queries using natural language.

Custom Dashboards

Build internal tools with real-time billing data. Track revenue, outstanding payments, and trends.

Rate Limits

Generous limits with clear headers

60 requests/min
Standard
Up to 100 requests
Burst
Rate limit info in response headers
Start Building

Ready to integrate?

Get your API token in minutes. Full documentation with examples in multiple languages.

Get StartedView Documentation

Free tier available • No credit card required