Get Report By ID

Retrieves the status and download link of a previously generated report.

Request Parameters

Name	Type	Required/Optional	Description
reportHistoryId	number	Required	The report history ID of the report to retrieve.

Request Information

Category	Value
HTTP request	POST
URL	https://bikapi.bikayi.app/integrations/bikPlatformFunctions-getReportById

Sample Request

curl --location --request POST 'https://bikapi.bikayi.app/integrations/bikPlatformFunctions-getReportById' \
--header 'Authorization: Basic AUTH_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
 "reportHistoryId": 44551,
}'

JSON response example:

{
    "status": 200,
    "success": true,
    "data": {
        "downloadLink": "https://firebasestorage.googleapis.com/sample-link",
        "reportStatus": "COMPLETED",
        "cursor": "2025-08-15T13:56:33.906Z"
    }
}

Response parameters

Name	Type	Description
status	number	HTTP status code
success	boolean	Indicates whether the request succeeded
data.downloadLink	string	URL to download the report in CSV format
data.reportStatus	ReportStatus	Current status of the report. Check the Report status type here.
data.cursor	string \| null	Resume cursor for partial exports (currently supported by All Conversations Report). When non-null, indicates the export was capped and more data remains. Pass this value as cursor in a subsequent Generate Report call to fetch the next batch. null means the export is complete.

Report Status Type

Name	Type	Description
QUEUE	string	The report generation is queued.
IN_PROGRESS	string	The report is being generated.
COMPLETED	string	The report generation is complete.
FAILED	string	The report generation has failed.

Errors

Error Code	Meaning
400	Invalid payload! -- Your request is invalid/invalid parameters.
401	Unauthorized -- User is not authenticated.
404	Not Found -- The specified API could not be found.
500	Internal Server Error -- We had a problem with our server. Try again later.

Error response example:

{
  "status": 400,
  "errors": [
    {
      "message": "Invalid payload!"
    }
  ]
}