Skip to main content
POST
/
api
/
v2
/
conversation
/
batch
Fetch multiple conversations
curl --request POST \
  --url 'https://api.vida.dev/api/v2/conversation/batch?token=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "roomId": "2236859:2550714",
      "uuid": "bf0011ed-8175-458a-8fba-1e62ddc77567:1770763782"
    },
    {
      "roomId": "2236859:2535655",
      "uuid": "edf65410-9f78-4d5e-82d2-2ee773ad4a49:1770765260"
    }
  ]
}
'
{
  "success": true,
  "message": "Success",
  "stats": {
    "requested": 2,
    "ok": 2,
    "failed": 0
  },
  "results": [
    {
      "success": true,
      "roomId": "2236859:2550714",
      "uuid": "bf0011ed-8175-458a-8fba-1e62ddc77567:1770763782",
      "message": "Success",
      "conversation": [
        {}
      ]
    }
  ]
}

Authorizations

token
string
query
required

Vida API Token

Body

application/json
items
object[]
required

List of conversation lookup items (max 200).

Response

Batch lookup complete. Each item includes per-item success/failure.

success
boolean
Example:

true

message
string
Example:

"Success"

stats
object
results
object[]