Rasid Logo
Rasid
Developer API v1

Build invoicing into your app.

Generate professional PDF invoices programmatically in seconds. Secure, reliable, and designed for developers.

Get API KeyView Docs
99.9%
Uptime SLA
<500ms
Latency
10k+
Daily Invoices
curl -X POST https://rasid.in/api/v1/invoices/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "buyer": {
      "name": "Acme Corp",
      "email": "billing@acme.com",
      "address": "123 Tech Park, India"
    },
    "items": [
      {
        "description": "Software Development",
        "quantity": 160,
        "unitPrice": 2500,
        "taxRate": 18
      }
    ],
    "notes": "Thank you for your business"
  }'

Authentication

Rasid API uses API keys to authenticate requests. You can view and manage your API keys in the Developer Dashboard.

Security Notice

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc.

Headers
Authorization:Bearer <token>
x-api-key:rsd_live_...

Generate Invoice

Create a new invoice PDF. You can specify buyer details, items, tax rates, and more. The API will return a direct link to the generated PDF which is hosted on our secure CDN.

POST
https://rasid.in/api/v1/invoices/generate

Creates a new invoice and returns the PDF URL.

Parameters

buyer
Object containing name, email, address, etc.
items
Array of items. Each item must have description, quantity, and unitPrice.
currency
Optional. Default is 'INR'.
templateId
Optional. ID of the invoice template style.

Example Request

curl -X POST https://rasid.in/api/v1/invoices/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "buyer": {
      "name": "Acme Corp",
      "email": "billing@acme.com",
      "address": "123 Tech Park, India"
    },
    "items": [
      {
        "description": "Software Development",
        "quantity": 160,
        "unitPrice": 2500,
        "taxRate": 18
      }
    ],
    "notes": "Thank you for your business"
  }'

Sample Response

200 OK
{
  "success": true,
  "invoice": {
    "id": "inv_123456789",
    "number": "INV-2024-001",
    "date": "2024-01-09",
    "totalAmount": 472000,
    "pdfUrl": "https://cdn.rasid.in/invoices/inv_123456789.pdf",
    "status": "PAID"
  },
  "quota_remaining": 9998
}

Errors & Status Codes

401 Unauthorized

Your API key is missing or invalid. Please check your headers.

400 Bad Request

Missing required fields (like buyer name or items) or invalid data formats.

429 Too Many Requests

You have exceeded your API rate limit or monthly quota.