Demo Requests

2 API calls in this section.

List Demo Requests

System Configuration / Demo Requests

GET/system/demo-requests

Retrieves a paginated list of demo requests submitted by prospective tenants. Supports filtering by status and searching.

• Requires Bearer token

• User must be a System Admin

Response

• Returns list of requests with pagination metadata.

Query parameters

Parameter	Type	Description
page	string	Page number (default: 1) Page number (default 1) Page number (default: 1) Page number (default 1) Example: 1
limit	string	Items per page (default: 10) Items per page (default 10) Items per page (default: 10) Items per page (default 10) Example: 10
status	string	Filter by status: Requested, Under Review, In Progress, Converted, Canceled, No Response Filter by specific status Filter by status: Requested, Under Review, In Progress, Converted, Canceled, No Response Filter by specific status
search	string	Search by name, email, or phone number Search string for name, email, or phone Search by name, email, or phone number Search string for name, email, or phone

Headers

Parameter	Type	Description
Authorization	string	Example: Bearer {{access_token}}

Staging

Request

curl

1curl --globoff --request GET "https://staging-api.ondi.io/functions/v1/system/demo-requests?page=1&limit=10&status=&search=" \2  --header "Authorization: Bearer ${ONDI_ACCESS_TOKEN}"

Response examples

200OK

Response body

json

1{2  "success": true,3  "message": "data_retrieved_successfully",4  "data": [5    {6      "id": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",7      "created_at": "2023-11-27T10:00:00Z",8      "updated_at": "2023-11-27T10:00:00Z",9      "name": "John Doe",10      "email": "[email protected]",11      "phone_number": "+15551234567",12      "notes": "Interested in full suite",13      "interested_modules": [14        "delivery",15        "storefront"16      ],17      "status": "Requested",18      "status_history": [19        {20          "status": "Requested",21          "at": "2023-11-27T10:00:00Z"22        }23      ]24    }25  ],26  "page": 1,27  "limit": 10,28  "total": 129}

Update Demo Request Status

System Configuration / Demo Requests

PUT/system/demo-requests/:id/status

Updates the status of a demo request. Tracks the status change in the history.

• Requires Bearer token

• User must be a System Admin

Response

• Returns the updated demo request object.

Path parameters

Parameter	Type	Description
idRequired	string	UUID of the demo request UUID of the demo request Example: request-uuid

Headers

Parameter	Type	Description
Authorization	string	Example: Bearer {{access_token}}
Content-Type	string	Example: application/json

Body parameters

Parameter	Type	Description
statusRequired	string	New status. Valid values: Requested Under Review In Progress Converted Canceled No Response New status. Valid values: Requested Under Review In Progress Converted Canceled No Response

Staging

Request

curl

1curl --globoff --request PUT "https://staging-api.ondi.io/functions/v1/system/demo-requests/${ID}/status" \2  --header "Authorization: Bearer ${ONDI_ACCESS_TOKEN}" \3  --header "Content-Type: application/json" \4  --data-raw '{5  "status": "In Progress"6}'

Response examples

200 · Success Response400 · Error - Invalid Status

200OK

Response body

json

1{2  "success": true,3  "message": "status_updated_successfully",4  "data": {5    "id": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",6    "status": "Under Review",7    "status_history": [8      {9        "status": "Requested",10        "at": "2023-11-27T10:00:00Z"11      },12      {13        "status": "Under Review",14        "at": "2023-11-27T10:30:00Z",15        "by": "admin-uuid"16      }17    ],18    "updated_at": "2023-11-27T10:30:00Z"19  }20}