Get Event Form Count

Get Event Form Count

Base URL

https://apimobile.callproof.com

Endpoint

/api/ai/chat-bot/get-event-form-count

Purpose

Returns how many event forms were submitted for one or more users in a company within a date range. Used by the AI chat bot for event-form submission count questions.

HTTP Method

POST

Headers

Header	Required	Description
Authorization	Yes	Bearer access token

Security

• Yes – Requires Bearer Token authentication.

Parameters

Path Parameters

None.

Query Parameters

None.

Request Body

Parameter	Type	Required	Description
userId	integer or array of integers	Yes	User ID(s) whose event form submissions should be counted
companyId	integer	Yes	Company identifier used to scope the count
startDate	string	Yes	Start date in Y-m-d format
endDate	string	Yes	End date in Y-m-d format

Successful Response (200)

Returns the total number of matching event form submissions.

Field	Type	Description
clientStatusCode	integer	Status indicator for the client (for example, 200)
user_id	integer	Identifier of the authenticated user
company_id	integer	Identifier of the authenticated user’s company
data	integer	Count of event form submissions in the date range for the given user(s) and company
uri	string	Requested resource URI

Error Responses

Status Code	Meaning
200	Validation failed – response body uses clientStatusCode 422 with the first validation error message
400	Bad Request – event form count could not be retrieved
401	Unauthorized – missing, invalid, or expired Bearer token

• Validation (HTTP 200, clientStatusCode 422) – Missing/invalid userId, companyId, or dates not in Y-m-d format.
• 400 – Failed to fetch event form count, or invalid/missing parameters.
• 401 – Authentication failed or the access token is missing/expired.