Get Call History
GET/v1/users/{userId}/calls
Retrieves the call history for a user, including screened calls and call analysis results.
Each call log entry includes:
- Call metadata (timestamp, direction, caller/callee phone number)
- Screening status and outcome
- AI analysis results (if applicable)
Results are returned in reverse chronological order (most recent first).
Path Parameters
userId stringrequired
UUID for the given user
Header Parameters
x-hiya-product-version string
Product version. The standard "major.minor.patch" format is highly encouraged without any leading characters; "2.1.3" or "3.0.0" for example.
x-hiya-account-user-id stringrequired
The identifier of a logged-in user. Same identifier that is used for /users/{user_id}
Responses
- 200
- 400
- 404
- 500
OK
Response Body
Bad Request
Response Body
Not Found
Response Body
Internal Server Error
Response Body