Api Reference

Create invoice

post

Creates a new invoice with the specified rate and period for the authenticated application.

Authorizations

X-API-Key

X-API-KeystringRequired

API Key needed to access the endpoints

Body

application/jsontext/jsonapplication/*+json

messagestring | nullableOptional

ratenumber · doubleOptional

periodstring · enumOptionalPossible values:

metadataobject | nullableOptionalExample: {}

Responses

200

Invoice created successfully

application/json

400

Bad request - Invalid parameters

401

Unauthorized - Invalid or missing API key

500

Internal server error

post

/api/invoice

HTTPcURLJavaScriptPython

POST /api/invoice HTTP/1.1
Host: bot-api.papaya.ws
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "message": "text",
  "rate": 1,
  "period": "PerDay",
  "metadata": "{}"
}

application/jsontext/jsonapplication/*+json

{
  "id": 1,
  "rate": 1,
  "createdAt": "2026-01-24T21:44:17.240Z",
  "botUrl": "text"
}

Get invoice by id

get

Retrieves a specific invoice by its ID, ensuring it belongs to the authenticated application.

Authorizations

X-API-Key

X-API-KeystringRequired

API Key needed to access the endpoints

Path parameters

idinteger · int64Required

Responses

200

Invoice created successfully

text/plainapplication/jsontext/json

400

Bad request - Invalid parameters

text/plainapplication/jsontext/json

401

Unauthorized - Invalid or missing API key

404

Not Found

text/plainapplication/jsontext/json

500

Internal server error

get

/api/invoice/{id}

HTTPcURLJavaScriptPython

GET /api/invoice/{id} HTTP/1.1
Host: bot-api.papaya.ws
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "id": 1,
  "recipient": "text",
  "rate": 1,
  "createdAt": "2026-01-24T21:44:17.240Z",
  "isPaid": true,
  "metadata": "{}",
  "botUrl": "text"
}

Get all subscriptions

get

Retrieves all subscriptions for the authenticated application with pagination support.

Authorizations

X-API-Key

X-API-KeystringRequired

API Key needed to access the endpoints

Query parameters

pageinteger · int32OptionalDefault: 1

limitinteger · int32OptionalDefault: 50

Responses

200

Returns paginated list of subscriptions

application/json

401

Unauthorized - Invalid or missing API key

500

Internal server error

get

/api/subscriptions

HTTPcURLJavaScriptPython

GET /api/subscriptions HTTP/1.1
Host: bot-api.papaya.ws
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": 1,
      "chainId": 1,
      "tokenName": "text",
      "tx": "text",
      "tgUserId": 1,
      "userAddress": "text",
      "createdAt": "2026-01-24T21:44:17.240Z",
      "isActive": true
    }
  ],
  "totalCount": 1,
  "page": 1,
  "limit": 1,
  "totalPages": 1
}

Get subscription by ID

get

Retrieves a specific subscription by its ID, ensuring it belongs to the authenticated application.

Authorizations

X-API-Key

X-API-KeystringRequired

API Key needed to access the endpoints

Path parameters

idinteger · int64Required

Responses

200

Returns the requested subscription

application/json

401

Unauthorized - Invalid or missing API key

404

Subscription not found

500

Internal server error

get

/api/subscriptions/{id}

HTTPcURLJavaScriptPython

GET /api/subscriptions/{id} HTTP/1.1
Host: bot-api.papaya.ws
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "id": 1,
  "chainId": 1,
  "tokenName": "text",
  "tx": "text",
  "tgUserId": 1,
  "userAddress": "text",
  "createdAt": "2026-01-24T21:44:17.240Z",
  "isActive": true
}