Skip to main content
GET
/
v1
/
meetings
/
invites
/
{id}
Get meeting invite
curl --request GET \
  --url https://api.anam.ai/v1/meetings/invites/{id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.anam.ai/v1/meetings/invites/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anam.ai/v1/meetings/invites/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anam.ai/v1/meetings/invites/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anam.ai/v1/meetings/invites/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.anam.ai/v1/meetings/invites/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.anam.ai/v1/meetings/invites/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{ "id": "00000000-0000-0000-0000-000000000000", "provider": "google_meet", "meetingUrl": "https://meet.google.com/abc-defg-hij", "displayName": "Cara (AI)", "status": "pending", "createdAt": "2026-04-20T10:00:00.000Z", "joinAt": null, "groupCall": true, "sessionId": null, "region": "eu", "joinState": null, "statusReason": null }

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Meeting invite ID.

Response

Successfully retrieved meeting invite

A meeting invite created for a persona.

id
string<uuid>
required

Unique identifier for the meeting invite.

provider
enum<string>
required

Meeting provider inferred from the meeting URL.

Available options:
google_meet,
zoom,
microsoft_teams
meetingUrl
string<uri>
required

Normalized meeting URL.

displayName
string
required

Display name used in the meeting.

status
enum<string>
required

Current invite status.

Available options:
pending,
active,
cancelled,
ended,
failed
createdAt
string<date-time>
required

Time the invite was created.

joinAt
string<date-time> | null
required

Scheduled time the persona joins the meeting, or null when the persona was asked to join immediately.

groupCall
boolean
required

Whether group-call turn-taking is enabled for this invite (respond only when addressed by name; silent join).

sessionId
string | null
required

Engine session ID once the meeting session has started, otherwise null.

region
enum<string> | null
required

Region the persona joined the call from. May differ from the requested region when the invite was served by another region for availability. Additional region values may be introduced over time; treat unrecognized values as informational rather than an error.

Available options:
eu,
us-east,
us-west,
null
joinState
enum<string> | null
required

Latest observed call-participation detail for the persona, updated asynchronously as the persona connects, waits for admission, joins, and leaves. Null until the first update arrives. Values may be added over time; treat unrecognized values as informational.

Available options:
joining,
waiting_room,
in_call,
media_denied,
media_granted,
media_active,
left,
done,
error,
null
statusReason
string | null
required

Reason attached to a terminal participation state — for example removed_by_host, meeting_ended, not_admitted, join_denied, meeting_link_invalid, meeting_not_started, idle_timeout, left_call, or provider_error. Null while the invite is in progress. Values may be added over time; treat unrecognized values as informational.

Last modified on July 10, 2026